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I. 



INTRODUCTION 



A. BACKGROUND 

The Computer-Aided Prototyping System (CAPS) [Ref. 1] is an integrated 
collection of software tools that support the development of software systems using 
the prototyping paradigm. The focus of CAPS is the development of hard real-time 
embedded software systems [Ref. 2]. Through the use of the prototyping paradigm, 
CAPS is especially well suited to support the development and validation of system 
requirements as well as feasibility studies [Ref. 3]. 

The software tools that comprise CAPS are organized into four major subsys- 
tems: Editors, Software Base, Execution Support, and Project Control (see Figure 1) 
[Ref. 4]. Underlying each of these subsystems is the Prototype System Description 
Language (PSDL) [Ref. 3]. 

Prototypes developed in CAPS are specified using PSDL. PSDL is a high- 
level language, rich in abstraction and with facilities for capturing the requirements 




Figure 1. CAPS Subsystems, After [Ref. 4] 
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of real-time systems. In PSDL, a prototype is partially specified as an augmented 
data flow diagram. A representation of a PSDL prototype is provided in Figure 2. 
The augmented data flow diagram is depicted by the shaded box at the top of the 
figure. 

A data flow diagram consists of a network of operators which communicate 
through data streams. The data flow diagram depicted in Figure 2 is composed 
of three operators (represented as circles) and two data streams (represented as the 
directed-lines connecting the circles within the shaded box). The data flow diagram is 
augmented with timing and control constraints. In Figure 2, each operator is assigned 
a Maximum Execution Time (MET), which can be found at the bottom-right of each 
operator. In this example, all MET values are in milliseconds (ms). 

A data flow diagram is one element of a PSDL component. PSDL provides 
two kinds of components: abstract state machines and abstract data types. An aug- 
mented data flow diagram is a visual abstraction of the processing to be performed by 
an operator. Operators are introduced through PSDL components. An abstract state 
machine specifies a single operator. Multiple operators can be introduced as part of 
an abstract data type. The prototype itself is implemented as an operator defined by 
an abstract state machine. There are two parts to each component: a specification 
and an implementation. The specification defines the component’s interface. The 
component’s implementation can be realized by either decomposing the component 
into a more detailed data flow diagram or by a reference to a programming language 
implementation. Figure 2 depicts the top level data flow diagram of a robot proto- 
type. In this example, each operator has been implemented with a reference to a 
programming language implementation, illustrated by the three boxes below the aug- 
mented data flow diagram. The current release of CAPS supports two programming 
language implementations. An operator can be implemented as an Ada package or 
as a TAE module, providing a graphical interface. [Ref. 5] 

The Editor subsystem provides a collection of editors which are tailored to the 
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PACKAGE robot_sim_Pkg IS 
PROCEDURE 
robot_sim ( 
thrust_cmd: 

IN thrust_vec; 
robot_state ; 

OUT state_vec) ; 
END robot_sim_Pkg; 

PACKAGE BODY 

robot_sim_Pkg IS 



Robot Position Monitor 




TAE+ Implementation Ada Implementation TAE+ Implementation 

Figure 2. PSDL Data Flow Diagram and Implementation 



ingredients of a CAPS prototype. The primary CAPS editor is the PSDL Editor. 
This editor is unique to CAPS and has been designed specifically for the development 
of PSDL prototypes. A graphical interface to support the data flow diagram as well 
as syntax generation and checking facilitate improved user efficiency in prototype 
development. Other editors are provided to edit the Ada packages and the TAE 
graphical interfaces which realize the prototype. 

The Software Base subsystem provides CAPS with a repository of reusable 
prototype components. Facilities are provided to browse as well as query the compo- 
nent repository. Queries can be performed using the PSDL component specification. 
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[Ref. 6] 

The Execution Support subsystem is one of the key features of CAPS which 
allows for rapid prototyping of real-time systems. The Execution Support subsystem 
provides for the automatic generation of “supervisory” code based on the PSDL 
specification of the prototype. The “supervisory” code provides scheduling of time 
critical and non-time critical operators, implements buffered communication paths 
(e.g., data streams) with applicable initial values, implements the control constraints 
specified in the prototype, and provides support for timers and exception handling. 
All of which is automatically implemented by CAPS. 

The Project Control subsystem provides advanced project capabilities. The 
Evolution Control System facilitates prototype development in a team environment. 
The CAPS Merger provides an automated tool for change-merging of PSDL compo- 
nents. [Ref. 6] 

CAPS has been an ongoing research area at the Naval Postgraduate School 
(NPS) for nearly ten years. During this time, CAPS has been used to develop a 
variety of student projects and theses, including an autopilot system, a cruise missile 
guidance system, and a Communications, Command and Control Information warfare 
(C3I) system. The current version of CAPS is Release 1. [Ref. 7] 

B. CAPS RELEASE 1 PSDL EDITOR 

The PSDL Editor provided in CAPS Release 1 facilitated the full specifica- 
tion of a prototype in PSDL (refer to Appendix A for the definition of the PSDL 
grammar). Departing from typical editors, the PSDL Editor provided facilities to 
view and edit the PSDL augmented data flow diagram in its most natural form, a 
graph (this functionality will be referred to as the “graph editor” in this document). 
However, the graph editor was limited in its capabilities to fully specify a prototype. 
The graph editor provided for the entry of the PSDL data flow diagram along with 
associated labels (i.e., operator and data stream names). In order to maintain a sim- 
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pie abstraction of the processing to be performed, the PSDL properties^ displayed on 
the augmented data flow diagram were limited to those deemed most critical. For 
operators, the MET was supported. For data streams, the graph editor provided for 
the selection between a data stream and a state stream as well as for any stream 
latency. The remainder of the PSDL specification was supported through the use of 
a text editor. 

Once again, the CAPS designers departed from typical editors with the in- 
clusion of a syntax-directed editor to facilitate the required text editing. A syntax- 
directed editor is a language-based editor. With knowledge of a language’s syntax, a 
syntax-directed editor is capable of detecting and locating syntax errors. For CAPS, 
this means that PSDL syntax errors can be corrected in the editor rather than wait- 
ing for them to be detected by the Execution Support subsystem. In addition, a 
syntax-directed editor can provide the user with templates for structures within the 
language. The syntax-directed editor provided in CAPS Release 1 was implemented 
using the Synthesizer Generator, a commercial product developed by Thomas Reps 
and Tim Teitelbaum [Ref. 8]. 

Provided with a definition of a language’s abstract syntax, context-sensitive 
relationships, display format, concrete input syntax, and transformation rules, the 
Synthesizer Generator produces a language-based editor. Fundamental to the opera- 
tion of the Synthesizer Generator is the use of an attribute grammar. An attribute 
grammar is obtained by the addition of attributes to the nonterminal symbols of a 
context-free grammar along with a set of attribute equations. As an object is edited 
with a syntax-directed editor (created by the Synthesizer Generator), the object is 
represented internally by a derivation tree, which is based on the attribute grammar. 
It is the derivation tree which is traversed and modified through editing operations. 
[Ref. 8] 

^PSDL properties will be discussed in Chapter II. For the present, the MET and the Latency 
are timing requirements of the prototype. A state stream is a special case of a data stream which 
provides the prototype with memory. 
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In the CAPS Release 1 PSDL Editor, the graph editor and the syntax-directed 
editor were merged together to provide an integrated tool to facilitate the development 
of prototypes. The PSDL Editor was implemented by executing the syntax-directed 
editor and the graph editor in separate processes. The syntax-directed editor was 
the parent process. Two copies of the graph editor were executed, each in its own 
process. Upon startup of the syntax-directed editor, the first copy of the graph editor 
was created as a graph viewer. As the PSDL prototype was traversed in the syntax- 
directed editor, the graph viewer displayed the applicable data flow diagram. In order 
to edit the data flow diagram, a second copy of the graph editor was created as a 
graph editor. 

The implementation of the CAPS Release 1 PSDL Editor resulted in the cre- 
ation of an artificial boundary between the data flow diagram and the associated 
PSDL properties. This artificial boundary resulted in a two step process of proto- 
type development for the typical CAPS user. In this process, the user would create 
the data flow diagram of the prototype using the graph editor (reference Figure 3^). 
When the data flow diagram was reasonably complete, the user would return to the 
syntax-directed editor (reference Figure 4), where the associated properties would be 
entered. 

The separation between the syntax-directed editor and the graph editor fos- 
tered a single mind-set of operation in which all of the data flow diagram was entered 
prior to the use of the syntax-directed editor to enter the associated properties. State 
streams presented a large potential for error. If a user specified a state stream in the 
data flow diagram through the graph editor, the state stream was not implemented 
until the user again specified the state stream in the syntax- directed editor. 

The templates available in the syntax-directed editor provided assistance to 
the user in developing a syntactically correct prototype. At each stage of a prototype’s 
development, the syntax-directed editor was capable of prompting the user for the 

^This prototype is taken from the avionics-example found in Appendix B. 
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Figure 3. CAPS Release 1 Graph Editor 
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Figure 4. CAPS Release 1 Syntax-Directed Editor 
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legal alternatives within the PSDL grammar (refer to the bottom of Figure 4). In 
addition, the knowledge of templates enabled the syntax-directed editor to perform 
operations on entire structures, made available to the user from the Structure menu 
(refer to the top of Figure 4). 

However, due to differences between the attribute grammar programmed into 
the syntax-directed editor and the PSDL grammar definition (refer to Appendix A), 
the traversal of the derivation tree maintained by the syntax-directed editor was not 
always intuitive to the user. In some cases, additional nodes were inserted into the 
derivation tree which confused the user. In order to become proficient with the PSDL 
Editor, the user was required to become familiar with the unique features of the 
attribute grammar. 

A typical example is the editing of a type-declaration within a data stream 
structure. Figure 5 depicts a graphical representation of the type-declaration struc- 
ture from the PSDL grammar definition (starting with line 25 of Appendix A). Fig- 
ure 6 depicts how the same structure would be represented in the derivation tree of 
the syntax-directed editor, based on the attribute grammar. The derivation tree 
provided additional nodes to represent the set of types which were allowed INTEGER, 
REAL, BOOLEAN, and User-Defined. However, the definition of the attribute gram- 
mar was not intuitive to the typical CAPS user. Figure 7 depicts four snapshots 
of the syntax-directed editor in an example where the user wishes to modify the 
type used for the data stream av-consent-switch. Initially, the data stream is 
of type switch-position, a User-Defined type. The required type for the data 
stream is BOOLEAN. The user selects the type name, depicted by the underlined 
switch-position in the first snapshot. The user deletes this entry and expects 
to be presented with the decl-type-name options. However, syntax-directed editor 
is still located at the id node below DTypeUserDef ined within the derivation tree 
(refer to the second snapshot). The user is required to ascend to the parent (i.e., 
decl-type-naune) from the Structure menu and cut off the existing branch of the 
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Figure 5. PSDL Type Declaration 

derivation tree from the Edit menu (depicted in the third snapshot). The syntax- 
directed editor is now positioned within the derivation tree to prompt for the BOOLEAN 
option, which is selected and depicted in the fourth snapshot. 

Additionally, the syntax-directed editor’s attribute grammar stipulates an or- 
der in which PSDL structures can be arranged. In some cases, this order is defined 
in the PSDL grammar. In other cases, it is solely defined by the syntax-directed edi- 
tor. Regardless of the PSDL grammar, the syntax-directed editor requires a specific 
ordering of PSDL structures. The syntax-directed editor provides the user assistance 
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Figure 6. Derivation Tree Type Declaration 
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by prompting for all valid constructs at the cursor location. However, the user is re- 
quired to either memorize the order stipulated by the attribute grammar or to search 
through the prototype in order to identify the location for the desired construct. 

C. RESEARCH GOAL 

While the PSDL Editor provided advanced features for specifying the require- 
ments of a prototype in PSDL, it also introduced artificial boundaries and linear con- 
straints that impacted a users productivity. The goal of this research is to develop the 
next generation of the PSDL Editor in an attempt to overcome these impediments. 

As this research was envisioned, the development of the next generation of the 
PSDL Editor was divided between the graph editor and a background checker driver, 
written in Ada. This research was centered about the graph editor. This project was 
implemented as an evolutionary task. The CAPS Release 1 graph editor was used 
as the baseline from which this research was initiated. Additional work on the graph 
editor was accomplished partly through the class project for NPS CS4520 (AY96Q4). 
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II. PROTOTYPE SYSTEM DESCRIPTION 

LANGUAGE (PSDL) 



The primary reference for the Prototype System Description Language is the 
paper “j4 Prototyping Language for Real-Time Software” by Luqi, Berzins, and Yeh 
[Ref. 3]; which describes the semantics of PSDL. Refinements to the PSDL seman- 
tics are outlined in Professor Luqi’s class notes from the Naval Postgraduate School 
course CS4920; Computer Aided Prototyping Systems (AY96Q3) [Ref. 9]. These two 
sources, along with the PSDL syntax provided as Appendix A, define PSDL. 

This chapter provides an introduction to PSDL as background information for 
a discussion of the PSDL Editor. Here PSDL is described within the context of a 
CAPS tool set implementation. This serves two purposes. First, a background in 
PSDL is necessary in order to understand the required operation of the PSDL Editor. 
CAPS provides a language-sensitive editor. The PSDL Editor is solely dedicated 
to CAPS, incorporating many language dependent features designed to simplify the 
specification of a PSDL prototype. Second, this introduction serves to inform the 
CAPS user of limitations imposed by a CAPS implementation which deviate from 
the PSDL semantics. 

CAPS provides a set of integrated tools (reference Figure 1) designed to facil- 
itate the development of executable prototypes using PSDL. Limitations within the 
tool set have resulted in a CAPS implementation that does not fully comply with the 
PSDL semantics. With each new release of CAPS, an attempt is made to remove 
these limitations. This research effort comes between CAPS implementations. Cur- 
rently, CAPS is at Release 1. Release 2 is planned, but not yet fully defined for all 
CAPS subsystems. Release 2 does contain PSDL syntax changes. These changes are 
reflected in this introduction as well as in the next release of the PSDL Editor. How- 
ever, any changes which may be incorporated into the Execution Support subsystem 
tools (excluding those changes needed to support the new PSDL syntax) are unde- 
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fined at this time, and hence are not addressed here. Thus, the PSDL configuration 
which is addressed here is the CAPS Release 1 implementation with the addition of 
the CAPS Release 2 updated syntax. As a result of the syntax changes which will 
make up CAPS Release 2, prototypes developed with this PSDL Editor will not be 
compatible with CAPS Release 1. 

Since CAPS users are presented with an implementation which does not fully 
support the PSDL semantics, users could potentially design a prototype which utilizes 
a limitation. Limitations with an implementation require special consideration by the 
prototype developer and may require the designer to over-constrain the prototype 
in order to work around a limitation. For example, within the PSDL semantics, 
stream names are local. However, the CAPS Release 1 implementation operates as if 
stream names are global. In order to maintain the semantics of PSDL, a prototype 
designer must over-constrain the prototype by forcing unique stream names in order 
to maintain local streams. 

Thus, concessions must be made in the prototype design to make up for limi- 
tations in the support provided by the tools. The concessions provided here are in full 
compliance with the PSDL syntax. They simply over-constrain the design in order 
to work around a limitation. Prototypes which adhere to these concessions should 
be compliant with future releases of CAPS. Prototypes which do not adhere to the 
correct semantics of PSDL will most likely “break” in future releases. 

A. PSDL PROTOTYPE 

Figure 8 depicts the partial taxonomy of a PSDL prototype. A PSDL pro- 
totype consists of a set of components. PSDL provides two kinds of components: 
abstract state machines and abstract data types. An operator is an instance of an 
abstract state machine and can be introduced into the prototype by either an ab- 
stract state machine component or an operator of an abstract data type component. 
In PSDL, the operator is the basic computational entity [Ref. 10]. 
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PSDL PROTOTYPE 




Timer • • • • Abstract State Machine 
[Function, State Machine] 




Specification Implementation 
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Machine Implementation] 
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Figure 8. PSDL Taxonomy 
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A prototype is decomposed into a network of operators which communicate 
through data streams. Data streams carry objects of a fixed data type. Data stream 
objects can be either predefined data types or types defined by abstract data type 
components. 

The PSDL syntax provides for the description of this network as a data flow di- 
agram in which the vertices represent operators and the edges represent data streams. 
By itself, the data flow diagram is not sufficient to support the definition of a real-time 
system. PSDL augments the data flow diagram with control and timing constraints. 
The augmented data flow diagram together with a set of precedence rules provides 
sufficient information for the CAPS Execution Support subsystem to automatically 
generate the “supervisory” code used to control the execution and communications 
of operators. 

While the operator is the PSDL computational entity, the PSDL syntax does 
not provide for the complete implementation of all operators. A general purpose 
programming language is required to implement some operators^. Currently, CAPS 
supports the programming languages Ada and TAE to implement operators. CAPS 
generates Ada code for “supervisory” control. 

The “supervisory” code generated by the CAPS Execution Support subsystem 
controls the execution of PSDL operators. As can be seen from Figure 8, PSDL 
contains both time critical and non-time critical operators. Time critical operators 
are controlled by a static schedule. Non-time critical operators are controlled by a 
dynamic schedule. The static schedule is executed as a high priority Ada task. The 
dynamic schedule is executed as a lower priority Ada task that runs whenever the 
static schedule idles. [Ref. 9] 

^Operators which are implemented using a general purpose programming language are called 
atomic operators. 
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sv 




Figure 9. State Machine example 

1. Component Structure 

Every PSDL component is made up of two parts: a specification and an im- 
plementation. The specification defines the component’s interface and provides for 
the documentation of behavior and requirements tracing. The implementation can 
be performed using a PSDL supported programming language (for atomic operators) 
or further defined in PSDL (for composite operators). 

2. Abstract State Machines 

A PSDL operator is a state machine. A state machine contains a finite number 
of inputs, outputs, and state variables; each of which are represented as a data stream. 
Figure 9 provides an example of a state machine with two input streams (x and y), 
one output stream (z), and one state variable^ (sv). A function is a state machine 
with no state variables. 

When the state machine is executed, it reads one data object from each of 
the input streams. The output values of the state machine depend solely upon the 
current values of the input objects that were read and the current value of the state 
variables. At most, one data object is written to each output stream. [Ref. 3] 

An operator that is implemented using a PSDL supported programming lan- 

^In this example, state variables are depicted with bold lines. This is the convention used by the 
graph editor. 
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guage is referred to as atomic. In this case, the operator’s implementation specifies 
the programming language as well as the module name used to implement the op- 
erator. Operators that are not atomic are composite. A composite operator is itself 
decomposed into a network of operators; communicating through data streams. This 
establishes a parent-child relationship between operators. The composite operator 
being the parent and the operators contained in the decomposed network being the 
children. 

Composite operators provide for a hierarchical decomposition of a prototype. 
At the top most level, the prototype consists of a single operator, referred to as 
the root operator®. Children of the root operator can either be implemented as 
atomic operators or as composite operators. At the lowest level, all operators are 
implemented as atomic operators. 

PSDL provides timers as predefined abstract state machines. A timer behaves 
similar to a stopwatch. A timer is modeled as an elapsed time value and a run switch. 
As long as the run switch is on, the elapsed time value is incremented. Timers have 
four operations: start, stop, reset, and read. Start turns on the run switch. Stop 
turns off the run switch. Reset turns off the run switch and sets the elapsed time 
value to zero. Read returns the current value of the elapsed time. [Ref. 3] 

Timers are declared in the implementation section of a composite operator. 
Timers differ from operators in that they do not appear in the data flow diagram. 
Timer values (i.e, the result of a read operator) are accessed by referring to the timer 
by name within the control constraints of an operator. PSDL semantics provide for 
the insertion of a timer value into a data stream [Ref. 3]. Currently, this feature is 
not supported in the CAPS tools. The prototype designer should limit the use of 
timers to operator constraints. 

^The PSDL Editor only supports the root operator being implemented as a composite operator. 
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3. Abstract Data Types 

The abstract data type component introduces a new type name for a user 
defined type. An abstract data type defines a set of values and a set of operations 
on that value set [Ref. 11]. User defined data types are provided in addition to 
the set of predefined data types: boolean, character, string, integer, real, and 
exception. All PSDL abstract data types are immutable. An immutable type has a 
fixed set of values and the properties of an instance of a type cannot be changed [Ref. 
11]. PSDL has no mutable types or global variables® in order to prevent coupling 
problems between operators [Ref. 3]. 

The set of operations defined by an abstract data type component are im- 
plemented as PSDL operators. Similar to operators defined by an abstract state 
machine component, an operator defined in an abstract data type component can 
be implemented either in a PSDL supported programming language or as a PSDL 
augmented data flow diagram. Since an immutable type has no memory (i.e., no state 
variables) [Ref. 11], it is a good design principle to limit abstract data type operators 
to functions and avoid state machines and timers. 

Data streams carry objects of an abstract data type, the data stream type 
being assigned in a PSDL type declaration construct. Abstract data type operators 
can appear within a data flow diagram as an operator by providing the type name 
and the operator name separated by a (e.g., stack. push where stack is the type 
name and push is the operator name). 

Unusual behavior of an operator can be flagged through the use of an ex- 
ception. PSDL facilitates this through the use of the built-in abstract data type of 
exception. Exceptions are identified by name. PSDL provides for the raising of an 
exception of a given name, detecting the presence of an exception with a given name, 

®The PSDL semantics specify that all streams are local. However, as currently implemented in 
CAPS Release 1, streams are global, based on the stream name. Thus, to be consistent with PSDL 
semantics, streams that are not local should have unique names. This is a concession made in the 
design of the prototype to work around a limitation in the CAPS tool set implementation. 
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and determining if no exception was raised (i.e., normal). 

The PSDL syntax provides for a time literal (reference production rule 36 of 
Appendix A) which consists of an integer and an associated time unit (i.e., microsec- 
onds, milliseconds, seconds, minutes, or hours). CAPS Release 1 does not support 
any time resolution less than one millisecond. Thus, the CAPS Execution Support 
subsystem converts all time literals to a natural number of milliseconds. Any time 
literal less than a millisecond is converted to one millisecond. The PSDL does not 
provide a predefined abstract data type which can be used to support time literals. 

B. DATA FLOW DIAGRAM 

At the top level, a prototype consists of an operator, whose implementation 
is provided by an augmented data flow diagram. After the initial operator (i.e., the 
prototype level), the designer may choose to implement the behavior of an operator 
with a network of simpler operators or with an atomic operator. This process of 
decomposing complex operators into simpler composite operators is continued until 
all remaining operators are atomic. The resulting structure is a hierarchical tree, 
in which the root is the prototype operator, all internal nodes are implemented as 
composite operators, and all leaf nodes are implemented as atomic operators. 

An augmented data flow diagram consists of a data flow diagram depicting a 
network of operators (communicating through data streams) as well as control and 
timing constraints on the network. A sample prototype is depicted in Figure 10, in 
which two data flow diagrams are included. The root operator is implemented as a 
composite operator, and hence has an associated data flow diagram. The operator b 
is also a composite operator and contains an associated data flow diagram. 

A data flow diagram can accept inputs from an external producer and produce 
outputs which are used by an external consumer. The inputs and outputs of a com- 
posite operator are declared in the composite operator’s specification section. These 
inputs and outputs correspond to the inputs and outputs depicted in the parent data 
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Figure 10. Sample PSDL Decomposition 
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Figure 11. Operator Precedence Relationship 



flow diagram. This can be seen in Figure 10. Within the operator b component, 
the specification declares x to be an input and y to be an output. These inputs and 
outputs correspond to the streams into and out of the subject operator (i.e., b) de- 
picted in the parent data flow diagram (i.e., the root operator). The root operator 
corresponds to a closed system, in which there are no external inputs or outputs. 

While the PSDL syntax supports a textual description of the augmented data 
flow diagram, the PSDL Editor provides a graphical interface to the user for creating, 
maintaining and browsing the data flow diagram. Within the graphical interface, an 
operator is represented as a bubble and a data stream is represented as a directed 
line segment from the producer operator to the consumer operator. 

A precedence relationship establishes a partial ordering of the execution sched- 
ule based on the data stream paths between operators. Figure 11 depicts two opera- 
tors, A and B, which share a data stream, X. The execution of B requires the availability 
of data from X. Hence, operator A must be executed prior to the execution of operator 
B. 

Figure 12 depicts the same state machine with a feedback loop added, data 
stream FB. In this situation, each operator depends on the output of the other oper- 
ator. CAPS requires that every cycle within a data flow diagram be broken with a 
state stream. That is, one of the data streams on the cycle must be designated a state 
stream and provided with an initial value. The initial value of the state stream breaks 
the circular precedence relationship that would otherwise be impossible to schedule. 
In order to obtain a valid PSDL prototype, the designer must ensure that the data 
streams (excluding state streams) of every data flow diagram form a directed acyclic 
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FB 




Figure 12. Cyclic Precedence Relationship 



SV 




Figure 13. Data Flow Diagram Loop 

graph (DAG). Each cycle which is found in the data streams of a data flow diagram 
must be broken, either by the removal of a data stream or by designating one of the 
data streams to be a state stream. This rule applies to simple loops as depicted in 
Figure 13. 

1. Operators 

In support of real-time prototypes, PSDL provides both time critical and non- 
time critical operators (reference the taxonomy of an operator depicted in Figure 8). 
Execution of time critical operators can be triggered either periodically or sporadically 
(i.e., data driven). 

In order for the CAPS Execution Support subsystem to obtain a schedule 
which executes each operator consistently with the timing constraints of the aug- 
mented data flow diagram, a bound must be placed on the execution time of the 
operators. This bound is referred to as the maximum execution time (MET). An 
operator is time critical if and only if it has been assigned an MET. Otherwise, the 
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operator is non-time critical. [Ref. 3] 

A time critical operator is triggered periodically if it contains a period (P) 
timing constraint. Otherwise, the operator is triggered sporadically, based on the 
arrival of data (i.e., data driven), and must contain a data trigger control constraint. 

Since a PSDL prototype represents a closed system, often it is necessary to 
include operators which are not considered to be part of the prototype to create the 
closed system. PSDL facilitates the inclusion of these external systems as terminators. 
Terminators are operators with an assigned MET of zero^, and thus the time required 
to execute the terminator is not counted against the prototype execution time. The 
CAPS maintains a simulated real-time clock. During the execution of a terminator, 
the simulated real-time clock is turned off. Terminators are represented in the PSDL 
Editor by a rectangular bubble within the data flow diagram. Operators with a non- 
zero MET (including those operators with an undefined MET) are represented in the 
PSDL Editor by a circular bubble. 

2. Streams 

Streams are used to communicate data objects of a fixed data type from a 
set of one or more producer operators to a set of one or more consumer operators 
[Ref. 9]®. While the PSDL syntax and the PSDL Editor represent a stream as a link 
from one producer to one consumer, multiple producers and multiple consumers are 
supported by matching stream names (i.e., identifiers) within the stream scope. 

PSDL provides two types of data streams: data flow streams and sampled 
streams. A data flow stream guarantees that no data object is lost or replicated. The 
data flow stream behaves like a first-in-first-out (FIFO) queue with a length of one for 
each consumer. A sampled stream behaves like a single memory cell which contains 
one data object for each consumer. The most recent data value is obtained each time 

^Since all terminators have an MET of zero, they are considered time critical and are placed on 
the static schedule. 

®This implementation is a change from that presented in [Ref. 3]. 



24 



the stream is read. Thus, data objects may be lost if associated with a fast producer 
or replicated if associated with a slow producer. The type of data stream used is 
determined by the consuming operator’s trigger control constraint. If the consuming 
operator contains a triggered by all control constraint for a set of streams, those 
streams are data flow streams. Otherwise, the stream is a sampled stream. 

The FIFO queue length of one for a data flow stream restricts the relative 
execution rates between the producer and consumer operators. In order to guarantee 
that no data object is lost or replicated, the output rate of the producer must not ex- 
ceed the execution rate of the consumer for all data flow streams. No such restriction 
is placed on a sampled stream. 

3. State Streams 

State streams provide a state machine with memory. State streams are also 
used to schedule data flow diagrams that would otherwise be impossible to schedule 
due to circular precedence constraints. A state stream is declared in the specification 
section of the component in which the state stream first appears in the data flow 
diagram. In Figure 10, the state stream s first appears in the data flow diagram of 
operator b. The state stream declaration appears in the specification of operator b as 
well. Within the components of operators e and d, the producer and consumer of s 
respectively, s only appears within the specification’s output and input declarations. 

A state stream dififers from a data stream in that a state stream must include 
an initial value. It is the initial value of a state stream which makes it possible for a 
state stream to break a circular precedence constraint. A state stream is also required 
when connecting time critical and non-time critical operators [Ref. 9]. 

Note that, under CAPS Release 1, all state streams are implemented as sam- 
pled streams regardless of the trigger constraint. Data flow state streams are not 
provided. 
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Table I. PSDL Constraints 
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MCP is set instead, MRT defaults to MCP+MET. 

^Under CAPS Release 1, all state streams are implemented as Sampled Streams. 



4. Constraints 

Constraints augment the data flow diagram in order to control the execution 
of operators, generation of output, processing of exceptions, and timers. Constraints 
also determine the implementation of data streams. Table I lists the constraints 
required to obtain a specified functionality of operators and streams as well as those 
constraints which are optional. 

Execution guards provide for the conditional execution of an operator. Exe- 
cution guards are provided by the constructs: 

operator (opJd) [ triggered by all (idJist) ] [ if {expression) ] 
operator (opJd) [ triggered by some (idJist) ] [ if {expression) ] 

Only one of the above constructs is permitted for each operator of a data flow diagram. 
Each construct has two conditions, a data trigger condition and an if condition. The 
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two conditions can be used independently or together to provide an execution guard 
on the operator. 

The data trigger condition triggered by all is satisfied only if all of the 
streams listed in the {idJist) have new data objects (i.e., has been written to since 
the last read operation). The data trigger condition triggered by some is satisfied if 
at least one of the streams listed in the {idJist) has a new data object. A data trigger 
condition is required for a sporadic operator. It is an optional execution guard for 
periodic and non-time critical operators. As can be seen in Table I, the triggered 
by all condition is also used to designate a stream as a data flow stream for the 
consuming operator. 

The second condition within the execution guard is the if condition. Identifiers 
of the conditional {expression) are limited to those of input streams as well as those 
of visible timers and exceptions. 

Output guards provide for the conditional transmission of an operator’s output 
stream. The operator’s result is not transmitted over the stream unless the output 
guard expression is satisfied. One output guard is permitted for each of the operator’s 
output streams. Identifiers of the output guard expression are limited to those of the 
operator’s input and output streams as well as those of visible timers and exceptions. 

Exception guards provide for the conditional raising of an exception. Multiple 
exception guards are permitted, one for each exception to be raised. The resulting 
exception is transmitted on all output streams of type exception leaving the operator, 
subject to any output guard constraints defined for those streams. Identifiers of the 
exception guard conditional expression are limited to those of the operator’s input 
and output streams as well as those of visible timers and exceptions. If the exception 
guard conditional expression is missing, it is assumed to be true. 

Timer control constraints provide for the conditional control of a timer. Con- 
ditional control is provided to start, stop, and reset a timer. Identifiers of the timer 
control conditional expression are limited to those of the operator’s input and out- 
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Table II. PSDL Timing Constraints; From [Ref. 6] 



Periodic Operator 


Sporadic Operator 


Maximum Execution Time (MET) 
Period (P) 

Finish Within (FW) 


Maximum Execution Time (MET) 
Minimum Calling Period (MCP) 
Maximum Response Time (MRT) 



put streams as well as those of visible timers and exceptions. If the timer control 
conditional expression is missing, it is assumed to be true. 

There are five® timing constraint parameters used for a PSDL operator. These 
parameters are listed in Table II, under the class of time critical operators where they 
are used, and are defined as follows [Ref. 6]: 

Maximum Execution Time (MET) An upper bound on the execution 
time from start to finish of an operator. 

Period (P) The elapsed time between two successive triggerings of a periodic 
operator at the earliest possible moment. 

Finish Within (FW) An upper bound on the elapsed time that may pass 
between the earliest time that a periodic operator can be triggered and the 
latest time the operator must produce all output stream values. 

Minimum Calling Period (MCP) A lower bound on the amount of time 
that may pass between successive triggerings of a sporadic operator. 

Maximum Response Time (MRT) An upper bound on the amount of 
time that may elapse from the arrival of data which triggers an operator 
to the time that all output streams have been produced. 

The absence of a MET constraint is used to indicate that the operator is non- 
time critical. Otherwise, the operator is time critical. Only time critical operators 
are allowed to have timing constraints [Ref. 9]. Only the MET is displayed by the 
PSDL Editor on the data flow diagram. 



®MET appears twice in Table II, under both Periodic and Sporadic operators. 
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Figure 14. Periodic Timing Constraints; From [Ref. 9] 



Periodic operators are scheduled at nearly regular time intervals. Figure 14 
depicts the relationship between the timing constraints for a periodic operator. The 
MET and Period (P) must be assigned for a periodic operator. If a FW constraint is 
not specified, it is defaulted to P. 

Jitter is an upper bound on the time that may elapse between two successive 
executions of a periodic operator. The worst case of jitter is obtained with the default 
value of the FW constraint (i.e., FW = P). In such a case, the jitter is given by twice 
the difference of the P and the MET. Jitter can be reduced to zero by setting the FW 
constraint equal to the MET. 

Sporadic operators are triggered by the arrival of data. Figure 15 depicts the 
relationship between the timing constraints for a sporadic operator. The MET must 
be assigned along with either the MCP or the MRT or both. 

Limits are placed on the values of MCP and MRT in the absence of a pipelined 
execution implementation. The MCP must be greater than or equal to the MET. 
The MRT must be greater than or equal to twice the MET. If the MRT constraint 
is specified and the MCP constraint is left unspecified, then the MCP defaults to the 



29 



CP >= MCP 



MRT 




MET 



















\ 


^ data arrives 1 


data arrives 



Scheduling Interval 
Execution Time 



CP is the calling period 

Figure 15. Sporadic Timing Constraints; From [Ref. 9] 



difference between the MRT and the MET. If the MCP constraint is specified and not 
the MRT constraint, then the MRT defaults to the sum of the MCP and the MET. 

One additional timing constraint is provided for streams. Latency is the lower 
bound on the elapsed time from when data is written to a stream by the producer 
until the time that the data can be read from the stream by the consumer. Latency 
is also displayed by the PSDL Editor in the data flow diagram. 

C. HIERARCHICAL NETWORK 

A PSDL prototype is built of PSDL operators, implemented as either data 
flow diagrams or with a PSDL supported programming language, in a hierarchical 
manner. The root operator is at the top of the hierarchy, which is always implemented 
as a data flow diagram. Each of the operators referenced in the data flow diagram 
is also specified as a PSDL component (either as an abstract state machine or as an 
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operator of an abstract data type). 

The specification of each operator establishes the interface to the operator 
while the details are hidden in the implementation. For a given operator, the inputs 
and outputs declared in the specification correlate to the input and output streams 
of the corresponding operator of the parent’s data flow diagram. States depicted in 
the data flow diagram found in an operator’s implementation are also declared in 
that operator’s specification. Exceptions processed in an operator’s implementation 
are also declared in that operator’s specification. Timers processed in an operator’s 
implementation are declared in that operator’s implementation. The declaration of 
input and output streams, state streams, and exceptions is provided for with the 
automatic PSDL code generation of the PSDL Editor. However, the PSDL Editor 
has no provisions for the automatic generation of the timer declaration. It is the 
responsibility of the user to properly declare all timers. 

The use of a hierarchical structure comes with additional semantic require- 
ments. 

1. Root Operator 

A PSDL prototype contains a single root operator. Any operator that is not in 
a hierarchical decomposition of the root operator is considered to be a multiple root 
operator and represents an error. Use of the PSDL Editor ensures that a multiple root 
operator error can not occur. A single root operator is provided by the PSDL Editor 
upon entry. All subsequent operators are introduced as decompositional operators 
within a hierarchy. Within the PSDL Editor, if a composite operator is deleted, the 
child operators will be deleted. 

CAPS follows the convention that the name^° of the root operator is the same 
as that of the file name that contains the prototype. The extension “ . psdl” is added 

*°In order for CAPS to provide for duplicate operator names in different scopes, the PSDL Editor 
appends an operator identification number to the operator name. This identification number is not 
included in the PSDL prototype file name. 
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to the file name. 

While not limited in the PSDL syntax, the PSDL Editor limits the root op- 
erator to one which corresponds to a closed system. There are no inputs to, or 
outputs from, the root operator. If inputs and/or outputs are required, the scope 
of the prototype should be expanded so that the required inputs and/ or outputs are 
contained within the prototype^^ The only (attributes) (reference production rule 8 
in Appendix A) permitted within the specification of the root operator are generic, 
states, and exceptions. 

In addition, the PSDL Editor limits the root operator of the prototype to 
a PSDL implementation. No provisions are made in the PSDL Editor for a root 
operator implemented in a programming language. 

2. Stream Consistency 

Within the hierarchical structure of PSDL, a composite operator is imple- 
mented as a data flow diagram of a PSDL component at a lower level. All inputs to 
the composite operator must be utilized as an external input to at least one of the 
operators in the decomposed data flow diagram. Likewise, all outputs of the compos- 
ite operator must be utilized as an external output from at least one of the operators 
in the decomposed data flow diagram. A similar set of rules require that all external 
inputs to a decomposed data flow diagram must be inputs to the composite operator 
and all external outputs to a decomposed data flow diagram must be outputs from 
the composite operator. [Ref. 3] 

External streams in a decomposed data flow diagram inherit the stream’s data 
object type of the the composite operator. In addition, which type of stream (i.e., 
data flow stream or sample stream) is derived from the trigger constraint of the 

*^User provided inputs as well as output displays to the user are typically handled by an operator 
(or terminator) contained within the prototype. Such an input /output operator may be imple- 
mented in TAE. While user input and/or output may be considered external, the use of an operator 
(terminator) to capture the requirements and specification of the input and/or output is considered 
to “close” the prototype system. 
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consuming operator. For a composite operator, as explained above, an input to a 
composite operator must also be an input to at least one operator in the decomposed 
data flow diagram. The trigger constraints of both the composite operator and those 
of the applicable decomposed operators are used in the derivation of the type. [Ref. 

3 ] 

3. Timing 

The MET and the MRT of a composite operator must be consistent with the 
implementation of the operator as a data flow diagram. The MET and the MRT of 
the implementing data flow diagram must be no larger than that of the composite 
operator. The Period and the MCP of a composite operator are inherited be the the 
operators of the implementing data flow diagram. 

4. Visibility 

The CAPS semantics requires that operator names within a composite opera- 
tor are to be local to the component. In order to accomplish this, the PSDL Editor 
supports integer suffixes which are attached to the operator name (reference memo 
provided in Appendix C). This feature will not be available until CAPS Release 2. 

The CAPS semantics provides for all streams to be local. Streams with an 
identical name out of a common operator are local. Streams with identical names, but 
out of different operators are not local. However, as implemented in CAPS Release 
1, streams are global. That is, any two streams with a common name are visible. In 
order to maintain the PSDL semantics, all streams that are not desired to be local 
should have unique names. This is a concession made in the prototype design to 
workaround an implementation limitation of CAPS Release 1. 

When an exception is raised by an operator, the exception is transmitted on 
all data streams of type exception, regardless of the exception stream label, leaving 
the operator, subject to the stream output guard. The exception is transmitted only 
over local exception streams. Thus the exception is not transmitted over exception 
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streams which are outputs of another operator. At least one exception output stream 
should be provided for each operator which is capable of generating an exception. 
[Ref. 9] 

A timer is visible within the component in which it is declared. If the com- 
ponent’s data flow diagram contains a composite operator, then the timer is visible 
within the decomposed components. 

D. LEXICAL ELEMENTS 

Each PSDL component is composed of a sequence of lexical elements. Lexical 
elements are in turn composed of characters. A lexical element is either an integer 
literal, a real literal, a string literal, text, an identifier (including keywords), or a 
delimiter^^. 

When a prototype is maintained by the PSDL Editor, the editor will ensure 
that the prototype is syntactically correct. User input provided through the PSDL 
Editor’s graphical interface are validated as required and are automatically translated 
into a syntactically correct PSDL prototype. Thus many of the rules presented in 
this section do not impact the prototype developer since they are maintained by the 
PSDL Editor. If a developer chooses to maintain a prototype using any other system, 
it is the responsibility of the developer to adhere to the syntax of PSDL. Very little 
assistance in the form of error messages is provided to the developer who introduces 
syntactical errors into a prototype. In most cases, the PSDL Editor will not be able 
to recover from these syntax errors. 

1. Character Set 

The PSDL character set is composed of the 95 printable ASCII characters 
from ASCII ’u’ (space) through ASCII ’”’ (tilde) plus the line feed (ASCII character 
10) and horizontal tab (ASCII character 9) characters. 

^^The time literal mentioned earlier is not truly a literal. Rather, it is a grammatical rule which 
combines an integer literal with a keyword representing the time units. 
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Right brace, is a special character in that it is included in the PSDL syntax, 
however, it is not allowed to appear anywhere except the closing of a description or 
an Eixioms structure (reference production rule 45 of Appendix A for the definition 
of a character and production rules 15 and 16 for the use of The format eflPectors 
vertical tab, carriage return, and form feed can not appear anywhere other than the 
{text) field of the description or the axioms structures'^. 

2. Integer Literals 

An integer literal (reference production rule 43 of Appendix A) is an unsigned 
number. All integer literals are base ten and do not contain any character other than 
the digits 0 through 9.^'^ 

3. Real Literals 

A real literal (reference production rule 42 of Appendix A) is an unsigned real 
number. All real literals are base ten. A real number must contain a decimal value 
(which may be 0), a decimal point (’.’), and a fractional value (which may also be 
0). Exponential notation is not allowed. 

4. String Literals 

A string literal (reference production rule 44 of Appendix A) is any number 
of characters from the PSDL character set, delimited by quotations (’"’). There 
are four characters that are not allowed within a string literal: the quotation mark 
(’"’), the right brace character (’}’), and the format effectors horizontal tab and line 
feed. PSDL does not specify any limit on string literal length. The empty string is 
represented as Strings are case sensitive. 

^^The use of these characters is not recommended. 

^‘‘Within the PSDL Editor, integer literals are represented by a C integer data type. In the 
current implementation, this is a 32 bit value. Only the non-negative values can be represented as 
an integer literal. 
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5. Text 

Text (reference production rule 49 of Appendix A) can only appear within the 
description and the axioms structures of PSDL. Within these two structures, text 
is any number of characters from the PSDL character set, delimitated by braces (’{’ 
and Hence, the right brace (’}’) can not appear within the text. Any other 
character, including horizontal tab and line feed, are permitted within the text. Text 
is the only lexical element that is allowed to cross a line separator. 

6. Identifiers 

An identifier (reference production rule 41 of Appendix A) consists of a letter, 
followed by any number of letters, digits, or underscore (’_’) characters. All characters 
of an identifier are significant and are case sensitive.^® 

7. Reserved Words 

While not addressed in the specification of PSDL [Ref. 3], the implementation 
of the PSDL Editor utilizes reserved words. A list of these reserved words is provided 
in Table III. Reserved words can not be used as identifiers within the PSDL prototype. 
Reserved words differ from identifiers in that reserved words are case insensitive (e.g., 
OPERATOR, Operator, and operator are all reserved words). 

Table IV contains additional PSDL keywords that do not match the syntax 
of an identifier and hence are not reserved. However, they are still tokens within the 
PSDL syntax. The symbol ’u’ is used to represent a single space. This single space is 
part of the keyword and can not be altered by removal, adding of additional spaces, 
or replaced with a horizontal tab. 

In addition to the above keywords (Tables HI and IV), PSDL defines a set of 
identifiers that are available to the prototype developer. This set of identifiers and 

*®The PSDL Editor treats identifiers being case sensitive. Note that Ada identifiers are case 
insensitive [Ref. 12]. Since CAPS generates control code in Ada it is not advisable to name two 
identifiers that only differ in case. Moreover, the CAPS Release 2 PSDL Editor will convert all 
characters of the identifiers to lower-case. 
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Table III. PSDL Reserved Words 



abs 


false 


min 


sec 


all 


generic 


mod 


some 


and 


graph 


ms 


specification 


axioms 


hoturs 


not 


states 


boolean 


if 


operator 


timer 


description 


implementation 


or 


triggered 


edge 


initially 


output 


true 


end 


input 


period 


type 


exception 


integer 


property 


vertex 


exceptions 


keywords 


real 


xor 


external 


microsec 


rem 





Table IV. Additional PSDL Keywords 



controluconstraints maximuiiiuresponseutime 

datayStream minimumucallinguperiod 

finishywithin requiredyby 

maximumyexecutionytime resetytimer 



startytimer 

stopytimer 

triggeredyby 



their application are provided in Table V. 

Table VI contains additional identifiers that are defined by the PSDL Edi- 
tor for the purpose of describing the data flow graph. These identifiers appear in 
PROPERTY constructs of the PSDL syntax (reference production rules 20 - 23 in 
Appendix A). The attributes of the data flow diagram that are controlled by these 



Table V. Predefined PSDL Identifiers 



Identifier 


Application 


ADA 


Implementation Language 


TAE 


Implementation Language 


other 


Place holder for other implementation languages 


normal 


Exception 


character 


Predefined data type 


string 


Predefined data type 



37 



Table VI. PSDL Editor Identifiers 



Identifier 

color 

is_terminator 
label -font 
label-X-of f set 
label_y_of f set 
latency-font 
latency_x-offset 
latency-y-of f set 
met-font 
met_x_off set 
met-y-off set 
radius 
spline 

X 

y 



Application 

Integer representing color of Operator 

TRUE if Operator is a Terminator 

Integer representing font of Label 

Signed integer representing relative y position of Label 

Signed integer representing relative x position of Label 

Integer representing font of Latency 

Signed integer representing relative y position of Latency 

Signed integer representing relative x position of Latency 

Integer representing font of MET 

Signed integer representing relative y position of MET 

Signed integer representing relative x position of MET 

Integer representing radius of Operator 

List of absolute x, y positions of Splines 

Absolute X location of Operator 

Absolute y location of Operator 



identifiers are maintained by the PSDL Editor and are hidden from the user by the 
PSDL Editor. They will be visible in the PSDL prototype code generated by the 
PSDL Editor. 

8. Delimiters 

Delimiters are required to separate adjacent lexical elements. Delimiters in- 
clude a space character (except when included in a string literal or text), a line feed, 
or one of the symbols listed in Table VII. 

9. Comments 

The PSDL syntax does not provide for comments in the sense of comments 
provided by languages such as Ada. Provisions are made for structured documenta- 
tion of the prototype. The format and placement of these structures is defined by the 
PSDL syntax (reference Appendix A). The reserved words description, axioms, 
keywords, and required by are tokens used to introduce documentation into the 
prototype. 
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Table VII. PSDL Delimiters 



& 


9 


: 


[ 


( 


— 


< 


] 


) 


-> 


<= 


{ 


♦ 


. 


= 


1 




/ 


> 


} 


+ 


/ = 


>= 





Note that, while description and axioms constructs facilitate the textual 
documentation of the prototype, keywords and required by constructs are re- 
stricted to an (idJist). 

E. PSDL EXECUTION 

CAPS provides facilities for executing a PSDL prototype when supported with 
software components written in an underlying programming language (e.g., Ada) [Ref. 
3]. These software components may be. obtained from a software base of reusable 
components or supplied by the prototype developer. 

An executable prototype is generated in three steps, available through the 
Executive Support subsystem of CAPS. Figure 16 depicts the CAPS Release 1 user 
interface access to these steps^®. The first two steps (i.e.. Translate and Schedule) are 
used to generate the “supervisory” module which provides for control and commu- 
nication within the prototype. When Compile is invoked, the “supervisory” module 
along with the packages used to implement the atomic operators and data types are 
compiled. The prototype is run by invoking Execute. 

Translation actually involves two processes. The first process involves flat- 
tening the hierarchical structure of data flow diagrams in an expansion process. The 

^®Note that this version of the PSDL Editor is in support of the PSDL grammar which will 
be integrated with CAPS Release 2. This PSDL Editor is not compatible with CAPS Release 1. 
Comments on compatibility can be found in Appendix B. Execution of a PSDL prototype under 
CAPS Release 1 is covered here since it is likely that the same steps will still be required with CAPS 
Release 2. 
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Figure 16. CAPS Release 1 Executive Support 



second process is to generate the Ada code required to support the timers, exceptions, 
stream communication, and control constraints. 

The remainder of the “supervisory” module is generated by the scheduler. The 
scheduler creates a high priority Ada task to control the static schedule (i.e., time 
critical operators) and a lower priority Ada task to control the dynamic schedule (i.e., 
non-time critical operators). 

All of the generated “supervisory” code is gathered together in one file which 
is named after the prototype name with an “ . a” extension. Which, assuming that 
the prototype was successfully translated and scheduled, is compiled with the atomic 
operators and data types. The result is an executable prototype. 
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III. PSDL SYNTAX/SEMANTIC 
CONSIDERATIONS 



The PSDL Editor is a language sensitive editor with embedded knowledge 
of PSDL syntax and semantics. The PSDL Editor assists the user by ensuring a 
syntactically correct prototype, with limited automatic PSDL code generation and 
limited semantic consistency checking. In the CAPS Release 1 PSDL Editor, this 
was primarily accomplished by the syntax-directed editor produced by the Synthe- 
sizer Generator. The graph editor served two purposes. First, the graph editor was 
used to present the data flow diagram corresponding to the operator selected in the 
syntax-directed editor. Second, the graph editor was used to create/maintain the 
data flow diagram of an operator selected in the syntax-directed editor. Since only 
the structure, labels, and a few timing parameters of the data flow diagram could be 
displayed/entered in the graph editor, a simple interface was all that was required to 
integrate the two segments of the PSDL Editor. 

In an attempt to meet the goal of minimizing the artificial boundary produced 
by implementing the PSDL Editor with both a syntax-directed editor and a graph 
editor, as well as overcoming the linear constraints resulting from the syntax-directed 
editor, the user interaction with the syntax-directed editor was to be reduced and 
the focus placed on the graph editor. As this project is an evolution of the current 
PSDL Editor, the existing architecture of a syntax/semantics checker and a graph 
editor was maintained. With the user’s focus being placed on the graph editor, an 
expanded interface was required between the syntax/semantics checker and the graph 
editor. This change in focus also required a redistribution of the embedded syntax 
and semantic knowledge between the two editor segments. 

This research concentrated on the development of the graph editor. The syn- 
tax/semantics checker was implemented as an Ada program, refered to as the back- 
ground checker, in a parallel development effort by Professor Man-Tak Shing. The 
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Table VIII. PSDL Interface Structures Summary 



Structure 


Description 


Direction 


GRAPHJ)ESC 


Representation of a single operator plus 
some “global” data. 


SDE <-» GE 


ERRORJISGS 


Semantic errors detected by the syntax- 
directed editor. 


SDE -> GE 


ACTION 


Control requests for next action to be 
taken by the syntax-directed editor. 


SDE GE 



integration of the the background checker and the graph editor was a shared task. In 
order to accomplish this parallel development, a new interface was established. Unlike 
the interface which was utilized in the CAPS Release 1 PSDL Editor, which shared 
a minimal set of data flow diagram data, this interface shared the complete specifi- 
cation of a single PSDL operator. Additional data was shared to provide “global” 
prototype information to the graph editor was well as to support control functions. 
The interface was defined by the file ge.interface .h (reference the source listing of 
ge_interf ace .h found in Appendix D on page 195). 

Figure 17 depicts the interfaces of the PSDL Editor. External interfaces to 
the PSDL Editor provide for the reading/writing of the PSDL code as well as for 
user interaction with the editor through the Graphical User Interface. Internally, 
all editor segment communication is performed through the ge.interf ace .h data 
structures, represented by the dashed box inside the PSDL Editor of Figure 17. The 
ge.interf ace .h file contains three structures used to organize communications be- 
tween the background checker and the graph editor. These structures are summarized 
in Table VIII. 

The GRAPH J)ESC interface accommodates the representation of a single PSDL 
operator. This is symbolized by the box around operator d with an arrow pointing 
to the GRAPHJDESC data structure in Figure 17. The interface does not support the 
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Figure 17. PSDL Editor Interfaces 
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PSDL representation of the operator^^. Instead, coming from a PSDL file, the PSDL 
code is parsed by the background checker and attribute values are stored in the 
prototype data structure, local to the background checker. PSDL reserved words are 
removed. The association of an attribute value with a PSDL construct is provided 
implicitly in the data structure. In the other direction, coming from the Graphical 
User Interface, attribute values entered by the user are associated with, and stored 
into, the GraphObjectList data structure, local to the graph editor. It is not until 
the prototype is written to disk by the background checker that the attribute values 
are mapped into PSDL code. 

A. SYNTAX AND SEMANTIC KNOWLEDGE DISTRI- 
BUTION 

Since only a representation of the PSDL operator is shared between the back- 
ground checker and the graph editor, the majority of the embedded syntactical knowl- 
edge must reside in the background checker. The background checker is responsible 
for the input parsing of a PSDL prototype as well as the generation of the PSDL code, 
which is the output of the PSDL Editor. The syntactical knowledge embedded within 
the graph editor is limited to that required to validate the user supplied data values 
associated with a PSDL construct and limited, locally-scoped, semantic validation. 

A syntactically correct PSDL prototype is ensured in a two step process. First, 
all user supplied data values are validated prior to acceptance into the graph editor’s 
data structures. Second, all PSDL code is generated by the background checker, 
based on the inputs provided by the user from the graph editor. 

It is critical that the PSDL Editor generate syntactically correct prototypes. 
No matter what stage of a prototype’s development, the prototype must be syntac- 
tically correct. All viewing/editing of a prototype is accomplished from the graph 

^^The ge_interf ace . h accommodates some PSDL code in order to facilitate the editing of selected 
PSDL constructs which were too complex for the initial implement of the graph editor’s user interface. 
This includes all PSDL types and expressions. 
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editor. The graph editor does not receive or transmit the PSDL code. The code is 
encoded into the GRAPH_DESC data structure by the background checker. The back- 
ground checker is only capable of encoding the PSDL code into the internal data 
structure representation if it can parse the code. Currently, the background checker 
does not have any provisions for error correction of a syntactically incorrect prototype. 
The CAPS PSDL Editor can not be used to edit a syntactically incorrect prototype. 

The graph editor is embedded with a limited amount of PSDL semantic knowl- 
edge. Semantic consistency is primarily accomplished by limiting the user’s options 
to those that are semantically correct. The graph editor is limited to semantic issues 
that are local to an operator. The interface between the background checker and the 
graph editor is limited to a single operator. All global semantic issues are resolved 
by the background checker. 

Note that while a prototype which is not semantically correct can not be 
translated and executed by the Execution Support tools, it is not necessary that 
the prototype be semantically correct to be edited with the PSDL Editor. There 
are potential semantically incorrect prototypes which are not compatible with the 
PSDL Editor. However, there is no general limitation against semantically incorrect 
prototypes as there are with syntactically incorrect prototypes. 

B. USER SPECIFIED PSDL CONSTRUCTS 

It is the graph editor that provides the user interface for PSDL Editor. The 
graph editor does not understand PSDL syntax. Instead, the graph editor deals with 
a small collection of data objects from which a PSDL construct is built. It is the 
data objects provided by the user which are properly formatted with PSDL reserved 
words by the background checker to produce a PSDL prototype (i.e., PSDL code). 
The data types which must be supported by the graph editor can be derived from the 
PSDL grammar (reference Appendix A). Table IX lists the fundamental data objects 
which must be supported by the graph editor. Production rules provided in Table IX 
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Table IX. Fundamental PSDL Data Objects 



PSDL Data Object 


Defining Production Rule 


id 


41 


id list 


11 


operator id 


24 


type name 


10 


integer literal 


43 


text 

enumeration 


49 



Table X. Enumeration Values 



Enumeration Usage 


Enumeration Values, separated by ’ 1’ 


Operator Type 
Implementation Language 
Trigger 
Timing 

Time Literal Units 
State Stream Selection 


Operator I Terminator 

ADA 1 TAE 1 Others 

unprotected I By Some I By All 

Non-Time Critical 1 Periodic I Sporadic 

microsec 1 ms I sec I min I hour 

Yes 1 No 



refer to those specified in Appendix A which define the syntax of the data object. 

Enumeration values are provided in Table X. Some of the enumeration val- 
ues correspond to PSDL reserved words. However, some are used to free the user 
from implementation details of PSDL. For instance, the operator type (i.e.. Operator 
1 Terminator) does not correspond to any PSDL construct. The selection of a 
Terminator is encoded by setting the Maximum Execution Time of the operator to 
zero. In this case, the use of an enumerator, along with semantical knowledge embed- 
ded in the graph editor, are used to hide this implementation detail of PSDL from 
the user. 

There were specific PSDL constructs which were deemed too complex to be 
provided in the initial implementation of the graph editor’s user interface. Table XI 
lists those constructs for which syntactical knowledge was not embedded in the graph 
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Table XI. Complex PSDL Data Objects 



PSDL Data Object 


Defining Production Rule 


data type 


3 


interface 


7 


constraint options 


29 


expression 


39 


initial expression list 


32 



editor. In order to provide full functionality within this version of the editor, separate 
syntax checkers are provided for these constructs. The graph editor provides a text 
window from which these constructs may be viewed/edited^®. 



C. HIERARCHICAL STRUCTURE 

A PSDL prototype is implemented as a network of operators, which may or 
may not be connected. Syntactically, a PSDL prototype is simply a set of operators^®. 
A given operator consists of a specification and an implementation construct. It is 
the data flow diagram, contained in the operator’s implementation, which describes 
the prototype network. The prototype network itself is decomposed in a hierarchical 
manner, described by a tree, in which each operator can be described by its own 
network of PSDL operators. 

Figure 18 depicts the skeleton of a PSDL prototype^®. The prototype consists 
of nine operator components. The implementation construct of the root operator, 
proto, identifies the first level of vertices (i.e., operators) and edges (i.e., streams) 



^^Syntactical validation of these constructs is required in order to maintain a syntactically correct 
prototype. As of this writing, this facility has not yet been provided. 

Actually, a PSDL prototype is a set of operators and abstract data types. However, it is only 
the operators, which includes operators of an abstract data type, which are executed. For this 
discussion, we will consider operators only. 

^°The code presented here does not conform to the CAPS Release 2 semantics. In order to simplify 
the example, the unique identifier suflSxes have been deleted. The unique identifier suifixes will be 
introduced later in this chapter. 
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Figure 18. Sample PSDL Prototype 
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Current Operator 



which constitute the prototype network. Each operator identified in this network 
is contained in the PSDL prototype, the implementation of which may or may not 
be described as a network of PSDL operators. Figure 19 provides a corresponding 
hierarchical representation, along with a simple tree representation, of the PSDL 
prototype provided in Figure 18. 

Note that, while the decomposition of the PSDL network is represented as a 
tree, the PSDL network itself is not restricted to a tree. In general, the PSDL network 
can be implemented as a disconnected graph containing cycles. Figure 20 depicts how 
the prototype tree structure is fiattened into the PSDL network, which implements the 
prototype, proto. For each level of the tree, the resulting PSDL network is provided. 
The resulting network is representative of the outcome of the flattening process used 
by the Execution Support tools. While the original network of Figure 18, described 
by operator proto, was a simple tree consisting of three vertices, the flattening of the 
PSDL network resulted in a connected graph of six vertices containing a cycle. 

The tree describes the relationship between operators, not the communication 
paths between operators. In Figure 18, operator d has been selected as the current 
operator of interest. From Figure 19, it can be seen that operator b is the parent and 
that operators f , g, and h are the children. Operator proto is the root operator. 

Within the background checker, the entire PSDL prototype is maintained. 
The interfacing data structure, GRAPH_DESC (contained in ge.interface .h, reference 
Appendix D, page 195), only facilitates the representation of one operator. The 
current operator being edited is selected by the user, in a process of navigating through 
the prototype tree structure. Initially, the root operator is selected by the PSDL 
Editor as the current operator. 

Thus, for the prototype depicted in Figure 18, all nine operators would be 
maintained simultaneously within the background checker’s data structures. Within 
the graph editor, a single operator, such as the data represented by the shaded rect- 
angle (operator d) in Figure 19, would be maintained. Initially, the operator proto 
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would be presented to the user by the graph editor. As the user navigates through the 
operator tree, the operator represented in the graph editor data structures is replaced 
with the operator selected by the user. It is the responsibility of the background 
checker to extract and relay the information for the current operator to the graph 
editor. 

From a graph editor perspective, at most four levels of the prototype tree 
are relevant at any given time. It is the responsibility of the background checker 
to orchestrate the data of these four levels with the information contained in the 
GRAPH-DESC data structure. These four levels are represented in Figure 21, in which 
the graph editor has no visibility into the shaded regions^* . The operator of interest is 
the current operator. This is the operator which is being edited. Both the specification 
and the implementation constructs of the current operator are available for viewing 
and editing. One level down from the current operator are the children operators. 
Portions of the specification construct of the child operator are available for viewing 
and editing. The input/output constructs of the child’s specification are derived from 
the current operator’s data flow diagram. The functionality constructs of the child’s 
specification are also made available through the editing of operator options in the 
current operator’s data flow diagram. Also available from the operator options is the 
implementation language of the child operator. One level above the current operator 
is the parent. The parent operator is used by the background checker to derive the 
current operator’s specification construct (i.e., the input and output constructs). The 
parent operator is not directly visible from the graph editor. The final level which is 
visible is the root level. The actual root operator is not visible (unless it is the current 
operator). However, the root level contains global information, which is visible from 
any level. Specifically, abstract data types are global to the prototype and are visible 
from any level of the prototype tree. 

^'Note that, while the graph editor may have visibility into a region which is not shaded, the 
graph editor does not necessarily have the ability to write to an area that is not shaded. Much of 
this visibility is provided by the background checker providing derived information on the prototype. 
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Figure 21. Relevant PSDL Tree Levels 





The background checker is responsible for deriving the values to be inserted 
into the GRAPH_DESC data structure. Figure 22 provides the GRAPH_DESC data struc- 
ture extracted from ge_interface.h. Within the GRAPH_DESC data structure, the 
background checker provides several references to the prototype levels just discussed, 
starting with the current operator being identified by cur_op_name and cur.opjium. 
From this starting point, all children are readily available through the data flow di- 
agram. However, the parent can not be derived from the current operator. The 
background checker provides a reference to both the parent, parent_op_name and 
parent _op_num, as well as the root, root_op.name and root_op_num. 

The current operator’s specification is supported using several symbols. The 
cur_op_spec provides the PSDL code. The specification construct must be derived 
by the background checker. The input and output constructs are derived from the 
parent operator’s data flow diagram. This was seen in Figure 19, where the input 
and output streams of operator d could be derived from the data flow diagram of the 
parent operator, operator b. In this case, streams x and s were the input streams 
and z was the output stream. In order to minimize the PSDL syntactical knowl- 
edge required by the graph editor, the background checker provides a partial parsing 
of the operator’s specification. The operator’s input stream list, input-list, out- 
put stream list, output-list, and maximum execution time, cur_op-spec-met and 
cur _op-spec_met .unit, are all provided as objects which can be operated on by the 
graph editor. Note that a portion of the current operator’s specification is dependent 
upon the current operator’s implementation. For example, the list of states provided 
in the specification are derived from the current data flow diagram. For such cases, 
the PSDL code provided in cur-op-spec is not maintained while in the graph editor. 
The background checker will update these constructs as requested. 

The current operator’s implementation is composed of several objects. The 
majority of the operator’s implementation is provided in the data flow diagram. In 
addition, a list of timers, timer-list, and the data flow diagram’s informal descrip- 
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^************************************************************** */ 
/* typedef for the graph description structure */ 

^it*********************************************************'**** * ! 



typedef struct graph_desc_node{ 



/* From SDE to GE */ 
char* root_op_name ; /* 

int root_op_num; /* 

char* parent_op_name; /* 

int parent_op_num; /* 

char* current_op_naune; /* 

int current_op_niim; /* 



name of the root operator 

unique op_num of the root operator 

name of the parent of the current operator 

unique op_num of the parent operator 

name of the current operator 

whose dataflow graph is being edited 

unique op_num of the current operator 



*/ 

*/ 

*/ 

*/ 

*/ 

*/ 



/* From SDE to GE */ 

ST_LIST input_list; /* list of input streams */ 

ST_LIST output_list; /* list of output streams */ 

/* NOTE: only label, label_font, stream_type_name, 
state_initial_value, is_state_variable are 
meaningful in the input_list and output_list */ 



/* From SDE to GE */ 

int cur_op_spec_met ; 

int cur_op_spec_met_\init; 



/* MET is kept separate from the spec */ 

/* interface. Still, only the reqmts can */ 



/* MTS 11/25/96 

change cur_op_is_terminator from int to BOOLEAN */ 

BOOLEAN cur_op_is_terminator; 

/* Bi-directional between SDE and GE */ 

char* cur_op_spec; /* Specification of current operator which */ 

/* is edited with mini-sde. */ 

/* Bi-directional between SDE and GE */ 

OP_LIST opera tor_li St; 

ST_LIST stream_list; 

ID_LIST timer_list; 

char* graph_informal_desc; 



/* From SDE to GE */ 

ID_LIST avail_impl_langs ; /* An ID_LIST of available languages from */ 

/* which an operator can be implemented */ 

/* Bi-directional between SDE and GE */ 

char* global_types; /* SDE output of all types */ 

} GRAPH_DESC_NODE, *GRAPH_DESC; 



Figure 22. GRAPH.DESC Extract 
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tion, graph_informal.de sc, are supported. The operator’s data flow diagram is 
specifled by a linked list of operators, operator-list, and a linked list of streams, 
stream-list. 

All abstract data types are provided as PSDL code in global-types. This 
implementation of the graph editor does not provide graphical user interface support 
of abstract data types. However, the PSDL code, as derived by the background 
checker is made available to the graph editor. 

Upon returning control back to the background checker, the ge.interface .h 
data structures are used to update the PSDL prototype components. Primarily, 
this involves updating the current and child operators. However, global updates of 
components may be required to maintain consistency with changes introduced in the 
current operator. 

D. PSDL VALIDATION AND GENERATION 

The PSDL Editor ensures a syntactically correct prototype. In the CAPS 
Release 1 PSDL Editor, all of the syntactical knowledge was embedded in the syntax- 
directed editor. This was appropriate since, other than the data flow diagram, the 
prototype was edited through the syntax-directed editor. With the focus of this 
implementation being on the graph editor and the graphical user interface, the proto- 
type is now fully defined from the graph editor. Even with this change of focus, it is 
still possible to maintain the majority of the syntactical knowledge within the back- 
ground checker. However, with the editing of the prototype being accomplished in 
the graph editor and the syntactical verification being performed in the background 
checker, a time delay is inserted between the entry of the prototype data and the 
detection of any errors. The length of this time delay is dependent upon how the 
graph editor and background checker interface. In the CAPS Release 1 PSDL Editor 
implementation, the syntax-directed editor generated by the Synthesizer Generator 
performed incremental validation of PSDL syntax as the user typed [Ref. 8]. For this 
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implementation, the interface between the background checker and the graph editor 
is accomplished similar to batch processing. In this mode of operation, an operator 
is edited without assistance from the background checker. Upon the user request to 
verify the prototype, or upon changing the current operator to another operator, the 
background checker is called to perform syntax/semantic validation. 

There are two categories of errors which are detected by the PSDL Editor: 
syntactic and semantic. With automatic PSDL code generation by the background 
checker, syntactical errors are limited to user supplied input. Semantic errors are 
generally more global, typically involving one or more operators. Typically, semantic 
errors which are detected are based on a relationship between two symbols. With 
this distinction between the nature of the two categories of errors, it seemed reason- 
able to move the detection of syntactical errors to the graph editor, avoiding any 
delays introduced with a batch mode of operation, while semantic error detection 
being performed within the background checker. With the current architecture of 
the background checker and the graph editor, certain semantic errors can only be de- 
tected from the background checker, since only the background checker has a global 
perspective of the prototype. 

In addition to the generation of the PSDL constructs associated with user 
supplied inputs, the PSDL Editor supplies automatic code generation for redundant 
data. This feature is most apparent in the generation of PSDL code to support both 
the specification and implementation constructs of an operator. 

1. Validation of PSDL Constructs by the Graph Editor 

The graphical user interface of the PSDL Editor facilitates the validation of 
user supplied PSDL constructs. Validation of user inputs are performed prior to 
updating the graph editor internal data structures. In this manner, all user sup- 
plied inputs are validated prior to being relayed back to the background checker. All 
fundamental PSDL data objects listed in Table IX are validated by the graph editor. 
Table XII provides the routines and state machines, as applicable, in which the funda- 
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Table XII. Fundamental PSDL Data Object Validation 



PSDL Data Object 


Rule 


State Machine 


Routine 


id 


41 


N/A 


valid_id 


id list 


11 


N/A 


valid_id, checked individually 


operator id 


24 


Figure 23 


valid_op_id 


type name 


10 


Figure 24 


valid_type_name 


integer literal 


43 


N/A 


valid_integer_literal 


text 


49 


N/A 


Motif 


enumeration 






Motif 



mental data objects are validated. Validation routines are found in ge.utilities .c, 
which is included in Appendix D, starting on page 202. All enumeration values listed 
in Table X are validated by the graphical user interface by only allowing the user to 
select one value from a predefined .list. 

For the complex PSDL data objects listed in Table XI, the graph editor does 
not contain the syntactical knowledge to validate user supplied input. While required, 



u u u u u u u 




Figure 23. {opJd) Validation State Machine 
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level + + 




Figure 24. (typejname) Validation State Machine 
the facilities needed to provide this validation have yet to be implemented. 

2. PSDL Redundant /Derived Data 

The operator’s specification defines the external interface of the operator while 
hiding the details of the implementation. The specification provides a “summary” 
of the operator, and thus contains redundant information found in the operator’s 
implementation. The PSDL Editor provides support for this redundant information. 
The user is only required to enter data once. The background checker is equipped with 
the semantic knowledge required to derive the redundant data. In addition to saving 
the user from entering redundant information, this implementation avoids semantic 
errors due to inconsistencies between redundant data. If data is entered twice, there 
is the possibility that it will be inconsistent. If it is only entered once, there is no 
possibility for inconsistent data. 

The graphical user interface designed for the graph editor has been limited 
to the single entry of redundant data. There is no semantic knowledge regarding 
redundant data in the graph editor. All redundant data processing is performed by 
the background checker. 
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3. PSDL Semantic Consistency by the Graph Editor 

While limited by the local scope of a single operator, the graph editor is still 
capable of enforcing some semantic consistency. 

Within the scope of an operator, those operators used to implement the data 
flow diagram must be unique. Uniqueness of operator labels does not apply to op- 
erators of an abstract data type. Uniqueness is enforced upon user entry of the 
operator label. The routine imique_op_id, found in graph_object_list.C (reference 
Appendix D, starting on page 277), is used to test for uniqueness. 

The characteristic of an operator being implemented as a composite terminator 
(i.e., having a maximum execution time of zero) is inherited by all operators of the 
data flow diagram. The graph editor enforces this inheritance by limiting the user to 
the use of only terminators within the graphical user interface. 

Unlike the scoping rules for operator labels, which must be unique for non-type 
operators within a data flow diagram, multiple uses of a stream are allowed within a 
data flow diagram. While each operator implements its own type of stream (i.e., data 
flow stream or sampled stream), streams also contain global characteristics. These 
include stream type, state stream, and initial value. The graph editor provides for 
the propagation of these characteristics for all streams within the data flow diagram. 
It is the requirement of the background checker to maintain consistency of these 
global characteristics external of the current operator. The graph editor enforces 
consistency through the routine propagate_stream, found in graph.object.list .C 
(reference Appendix D, starting on page 277). 

With a global perspective, the background checker is capable of providing ad- 
ditional semantic validation. Specifically, the background checker has provisions for 
validating the input and output streams specifications in a child/parent relationship. 
As was seen previously in Figure 19, the data flow diagram of the parent operator 
defines the inputs and outputs to the child operator. When a child operator is imple- 
mented with a PSDL network, the external input and output streams present in the 
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child’s data flow diagram must exactly match the input and output streams found in 
the parent’s data flow diagram [Ref. 3]. External input and output streams which 
were not deflned in the parent’s data flow diagram are flagged as being illegal by 
the background checker. Input and output streams defined in the parent’s data flow 
diagram but missing from the child’s implementation are flagged as being missing. 

In these two cases, it is beyond the capability of the PSDL Editor to deter- 
mine a corrective action. Instead, upon detecting the error, the background checker 
provides an error message to the user. Facilities are provided to navigate directly to 
the parent or child operator in order to correct the problem. 

The background checker provides an additional test to warn against a semantic 
violation. As was previously mentioned in Chapter II, PSDL has no global variables. 
However, as currently implemented in CAPS Release 1, streams are global, based on 
the stream name. The background checker tests for the use of global streams and 
provides a warning on its use. 

Figures 25 through 27 provide an example of these error conditions which are 
detected by the background checker. Figure 25 provides the parent data flow diagram. 
Figure 26 provides the decomposition of operator b found in the parent’s data flow 
diagram. Figure 27 depicts the resulting error messages from this prototype. In 
this case, the parent’s data flow diagram specifies that operator op_b shall have an 
input, op.b.in, and an output, op_b_out. Within the implementation of operator 
op_b, found in Figure 26, two undefined, external streams are specified, called in 
and out. These two errors are reported as the first two errors in Figure 27. Next, 
the lack of input op_b_in and output op.b.out from the child’s implementation are 
reported as the next two errors in Figure 27. Finally, the global stream x is defined 
both in the parent’s data flow diagram and the child’s data flow diagram, without the 
stream being passed between the parent and the child. The final two error messages 
of Figure 27 report this condition. 
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rsDL editor: orrorjnossago: 



Figure 25. Parent Graph Depicting Errors 

E. PSDL SYNTAX CHANGES 

Several modifications have been made to the PSDL grammar in support of 
CAPS Release 2. The new PSDL Editor is required to support these changes. A copy 
of the CAPS Release 2 PSDL grammar is provided as Appendix A. A few small fixes 
have been incorporated, such as updates to the (letter) and (alpha .numeric) pro- 
duction rules. Previously, these rules allowed any number of consecutive underscore 
characters in an (id). The grammar rules have been changed (reference produc- 
tion rules 47 and 48 in Appendix A) to be consistent with the construct of identifiers 
in Ada. Another small change was the generalization of the implementation language 
identifier in the (typeJmpl) and (operator Jmpl) production rules (reference rules 17 
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Figure 26. Child Graph Depicting Errors 

and 18 in Appendix A). Previously, only Ada was allowed as an implementation^^. 

Two more substantial changes were made to the PSDL grammar which im- 
pact the PSDL Editor. From the standpoint of the user interface, these changes are 
transparent to the user. However, both require support from the PSDL Editor to 
implement. 

1. PSDL Data Flow Diagram Properties 

In CAPS Release 1, the PSDL file generated by the PSDL Editor was sufficient 
to support the Execution Support tools, yet was not sufficient to support the PSDL 

Currently, the only supported implementation languages are Ada and TAE. Facilities have been 
provided in the grammar for future supported languages. 
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Editor. The PSDL Editor provided an additional file, with an extension of “.grf”, 
to facilitate the presentation of the data flow diagram. In CAPS Release 1, the 
PSDL grammar did not have provisions to capture the full specification of the data 
flow diagram (i.e., the visual presentation requirements). In CAPS Release 2, the 
PSDL grammar has been updated with a property construct (reference production 
rules 21, 22, and 23 in Appendix A) for this purpose. This change provides for the 
tagging of properties to vertices and edges of a data flow diagram based on predefined 
identifiers. These properties capture the information which was previously recorded 
in the “ . grf” file. A list of these identifiers was provided in Chapter II as Table VI 
(page 38). Currently, these properties are only used by the PSDL Editor. 

2. Unique Identifier Suffixes in CAPS Release 2 

CAPS Release 2 introduced a new semantic convention for the purpose of 
enforcing PSDL scope rules. Professor Berzins described the conventions used in his 
email dated 25 July 1996, which has been provided as Appendix C. 

The semantics of PSDL requires that the operators within a composite PSDL 
operator (i.e., an operator which has been implemented with a PSDL network) be 
local to that operator. The scoping of operators is illustrated in Figure 28, a portion 
of a PSDL prototype, in which operators fm_a and fm_b both contain operators with 
common names, x, yet are local to their respective parent operator. However, this 
only applies to PSDL operators. Scoping for operators of a PSDL type are global, as 
PSDL types are globally available within the prototype heirarchy. Thus, t . x refers 
to the same operator of t, from both fm_a and fm_b. Note that within an operator, 
PSDL operator names must be unique, as was described previously. 

In order to implement the PSDL scoping rules, unique integer suffixes are 
attached to the PSDL operator identifiers, thus ensuring that all PSDL operators 
are unique. In addition to supporting the scoping rules of PSDL operators, suffixes 
are also used to support multiple instances of PSDL type operators within the same 
graph. Thus each operator, both PSDL operators as well as PSDL type operators. 
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Operator x_y 




Figure 28. Scope of PSDL Operators 



are assigned a vertex number within a data flow diagram. In addition, each PSDL 
operator is assigned an operator number. The convention is as follows: 

{op jname). {op jnum) -{vertex jnum) 

{type -op -name) -{vertex. num) 

The above prototype portion is depicted again in Figure 29, in which suffices have 
been included. 

Note that this is actually not a syntax change. The inclusion of operator and 
vertex number suffixes is within the syntax of an {id) (reference production rule 41 in 
Appendix A). The use of suffixes to implement the PSDL scoping rules is a semantic 
convention which is used by the CAPS subsystems. The implementation of the suffix 
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Operator x_y_18 




Operator fm_a_40 



Operator fm_b_42 





Operator Number Vertex Number 

Figure 29. PSDL Operator Suffixes 

convention is to be hidden from the PSDL Editor user, thus requiring the PSDL 
Editor to fully automate its suffix behaviour. 
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IV. 



USER-INTERFACE DESIGN 



The core of a PSDL prototype is the data flow diagram. In the CAPS Release 
1 PSDL Editor, the graph editor was solely used to edit/view the data flow diagram. 
Following the editing of the data flow diagram, the syntax-directed editor was used to 
edit all other constructs of the prototype. This release of the PSDL Editor attempts 
to streamline the editing process of a PSDL prototype by focusing the user interaction 
to the graph editor. 

From an inspection of the PSDL grammar (reference Appendix A), it can be 
seen that a large number of PSDL constructs can be synthesized by the editor, using 
simple user provided data objects (e.g., literal values, text strings, identifiers, and list 
of identifiers). As a PSDL prototype consists of a network of operators connected 
by streams, the PSDL constructs, and hence the user provided data objects, are all 
associated with either an operator or a stream. The only exception being abstract 
data types. Thus, a graphical user interface model was developed, which build upon 
the earlier data flow diagram effort of the CAPS Release 1 graph editor, with the 
addition of pop-up windows associated with operators and streams for the entry of 
user provided data objects. 

Complex PSDL constructs (e.g., expressions), as discussed in Chapter III, are 
associated with operators and streams as well. However, the complexity of these 
constructs does not lend themselves to a simple synthesis from user provided data 
objects. As an initial attempt of expanding the graphical interface of the PSDL 
Editor, the specification of these constructs was maintained in PSDL syntax. 

A large portion of the graphical interface produced by Captain Robert Dixon, 
USMC [Ref. 13], was maintained in this implementation. Primarily, the interface 
used for the data flow diagram was preserved, with a few enhancements. Expansion 
of the graphical interface was partially outlined as part of the NPS CS4520 (AY96Q4) 
class project, implemented by Mr. Douglas Lange and Mr. Dagohoy Anunciado. 
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Additional modifications and enhancements to the interface were a result of this 
research. 

A. PSDL EDITOR ENVIRONMENT 

The graphical user interface provided in CAPS Release 1 (i.e., the graph edi- 
tor’s interface) was built upon the X Window System^^, using the Motif^"* widget set. 
The selection of Motif for use in the CAPS Release 1 PSDL Editor was discussed in 
Captain Dixon’s thesis [Ref. 13]. Motif provides assistance in the development of an 
application by providing a standard look and behavior to the user interface. 

1. PSDL Editor Layout 

The PSDL Editor’s graphical user interface is designed to facilitate the speci- 
fication of a PSDL operator. As was discussed previously, the user interface is limited 
to a single PSDL operator at any given time. The PSDL Editor does not provide for 
the implementation language (e.g., Ada) editing of an operator. 

The PSDL Editor’s graphical user interface is depicted in Figure 30. The 

graphical user interface consists of six areas, which are identified in Figure 30 and 

discussed in the following paragraphs. Pop-up windows are used to support the 

specification of constructs directed at streams and operators of a data flow diagram. 
a. Main Window 

This is the X Window from which the user interacts with the PSDL 
Editor. The Main Window is equipped with a title along with several control 
widgets on the top bar. The title is composed of “PSDL Editor : ” and the name of the 
prototype. The prototype name is based on the file name (i.e., name of root operator) 
provided upon execution of the PSDL Editor. If no file name is provided, the title is 
set to DEFAULT_PR0T0_NAME. The operation of the control widgets is based on the X 

Window System is a trademark of the X Consortium. 

^■*Motif is a trademark of the Open Software Foundation. 
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Figure 30. PSDL Editor Layout 



Window System initialization. Reference Appendix E for notes on customization of 

the Main Window. 

b. Menu Bar 

Pull-down menus provide easy access to PSDL Editor functions. Stan- 
dard access to the pull-down menus is supported, accomplished using the left-mouse 
button. Figure 31 depicts all four pull-down menus. Note that the Menu Bar was 
distorted in the generation of this figure in order to display all four menus simulta- 
neously. Only one menu is available at a time in the PSDL Editor. 
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Figure 31. PSDL Editor Menus 



c. Tool Bar 

The Tool Bar is divided into two areas by a horizontal line. Above 
the line, buttons are provided to access tools for “drawing” the data flow diagram. 
Below the line, buttons are provided to access functions for editing several PSDL 
constructs. The functions provided here are relative to the current operator or are 
global in nature (e.g., the function Types is directed towards abstract data types). 
As will be seen later, other functions, available through pop-up windows, are relative 
to the operators and streams contained in the data flow diagram. The functions here 
(i.e., Spec, Timers, and Graph Desc) are directed to the operator indicated in 
the Identification Bar. 

The selected drawing tool, above the horizontal line, is independent of 
any tool selected below the horizontal line. While drawing functions are not active 
during the use of a tool below the horizontal line, upon exiting, the previously selected 

drawing tool remains in effect until another drawing tool is selected. 

d. Identification Bar 

The Identification Bar provides the name of the current operator 
(left data window) as well as the maximum execution time of the current operator 
(right data window). These values can not be modified at this level. Instead, the user 
is required to change the values from the parent operator’s data flow diagram. The 
values displayed from the root operator can not be changed. 
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e. Drawing Window 

This area is used to display/edit the data flow diagram. Scroll bars 
are provided as necessary to view the entire data flow diagram window. Beyond the 
area accessed through the window scroll controls, the Drawing Window can not 

be enlarged. If a larger drawing area is required, consider decomposing operators. 

/. Status Bar 

The Status Bar provides feedback to the user. Divided into three 
windows, the STATUS Bar provides: (1) an indication that the prototype ha.s been 
modifled (SAVE REQUIRED versus Save Not Required), (2) an indication that 
the prototype’s syntax should be verified (Check Syntax versus ERROR MSGS), 
and (3) a window for displaying status and error messages. 

The first two indicators are button widgets. The labels on the buttons 
are changed as required to provide feedback. Activation of the button provides a 
short cut to the desired function (i.e., save the prototype, perform a syntax check, 
and display any error messages). The last indicator provides an area to provide 
editor feedback. Typically, an information pop-up window is used to display an 
editor message. This window is used to remind the user after the pop-up window 
has been acknowledged. The window is automatically erased, typically on the next 
operation. 

2. Component Identification 

From the Main Window, the user can access an Operator Property or Stream 
Property pop-up window. This is accomplished by positioning the cursor over an 
object in the Drawing Window and pressing the right-mouse button. The appro- 
priate pop-up window will be accessed. Figures 32 through 34 provide an example of 
the these three windows. Component^® Identification numbers are provided, which 
reference into Table XIII (Index), providing identification of all displays/controls. 



this case, component refers to a Motif widget and not to a PSDL component. 
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Figure 32. PSDL Editor Component Identification 
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Figure 33. PSDL Editor Operator Pop-up Component Identification 




Figure 34. PSDL Editor Stream Pop-up Component Identification 
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Table XIII. : PSDL Editor Component Identification 
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Table XIII.: PSDL Editor Component Identification 



Validation 


•H 

PU 

0) 

•H 

•H 

cu 

•=1 

•a 

•H 

(H 

> 


Motif 


Motif 


Motif 


valid_id 


Not Validated 


N/A 


valid_id 


Motif 


valid_integer_literal 


Motif 


valid-id 


valid-integer .literal 


Motif 


T3 

•H 

•H 

i— 1 
> 


rH 

a 

0) 

4^ 

•H 

'I 

0) 

bO 

•P 

P! 

•H 

1 

•H 

iH 

> 


Motif 


valid-id 


Not Validated 


N/A 


Hides 










Yes 




Yes 






Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 




Yes 


Indicator 


Data 


Enumeration 


Enumeration 


Enumeration 


Data... 


N/A 


Data... 


Label... 


Enumeration 


Data 


Enumeration 


Label... 


Data 


Enumeration 


Label... 


Data 


Enumeration 


Label... 


N/A 


Data... 


Component Type 


Data Entry 


Select 


Select 


Select 


Control-IdList 


Control-Text 


Display Only 


Control-IdList 


Select 


Data Entry 


Select 


Control-IdList 


Data Entry 


Select 


Control-IdList 


Data Entry 


Select 


Control-IdList 


Control-Text 


Display Only 


Identification 


Operator Name 


Operator /Terminator Selection 


Implementation Language 


Trigger 


Trigger Identifier List 


Trigger If Condition 


Trigger Id Condition Expression 


Trigger Required By 


Timing 


MET Value 


MET Units 


MET Required By 


MCP/Period Value 


MCP/Period Units 


MCP/Period Required By 


MRT/Finish Within Value 


MRT/Finish Within Units 


MRT/Finish Within Required By 


Output Guard Control 


Output Guard Display 


Index 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


Window 


Operator 









































77 



Table XIII.: PSDL Editor Component Identification 
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3. Types of Components 

Under the Component Type column of Table XIII, the various types of user 
interaction are identified. The PSDL Editor utilizes a limited set of widgets to interact 
with the user. These components are used both for editing a data object as well as 
viewing a data object. Typically there is not sufficient space within a window to view 
all of a data type. Controls are used to access additional Motif widgets from which 
the entire data object can be viewed /edited. In most cases, an indication is provided 
that additional information is available through a pop-up window. 

The data flow diagram requires significant interaction. It will be discussed in 

another section. 

a. Display Only 

This widget provides no input/control functionality. It is only used to 
display data. Data may be obtained from the editor and displayed, as is the case for 
the Current Operator Name (Index 5). Alternatively, the input may be provided by 
the editor, but accessed from a control button, as in the case of Trigger Id Condition 

Expression (Index 26) which is accessed from the Trigger If Condition (Index 25). 

b. Data Entry 

This widget provides direct data entry through the keyboard. Prior to 
data entry, ensure that the mouse cursor is positioned within the Data Entry window. 
The user can scroll through the Data Entry window using the left and right arrow 

keys, as required. 

c. Select 

This widget provides a select-one-of function. Values act similar to an 
enumeration type. Values are predefined and only one value can be selected. The 
Select type may be either a radio widget, such as State Stream Selection (Index 
50), or a pull-down version, such as Implementation Language (Index 22). The pull- 
down version is activated by depressing and holding the left-mouse button over the 
component. Move the cursor over the desired value and release the mouse button. 
An example of the Implementation Language widget is provided in Figure 35. Note 
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Figure 35. Select Component 

that, in this example, the cursor is not visible. 

d. Control 

Control widgets are accessed by depressing the left-mouse button over 

the component. 

e. Control- Text 

Control-Text components access a pop-up Text window. An example 
of a Text Window is provided in Figure 36, in which the prototype’s abstract data 
types were accessed through the Types Tool (Index 14). 

Within the Text Window, the user can position the cursor with the 
mouse and edit the text. The cursor must remain within the Text Window while 
editing the text. Scroll bars are provided for moving through the text. Initially, 
all changes made within the Text Window are local to the Text Window. In order 
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Figure 36. Text Window Component 

to modify the prototype, the changes must be accepted. This is accomplished by 
depressing the OK button. Changes may be aborted by depressing the Cancel 
button. 

/. Control- IdList 

Control-Id List components access a pop-up identifier list editor. Within 
this window, a list of identifiers may be viewed/edited. An example of an Id List 
Window is provided in Figure 37, in which the operator’s Timer list is accessed 
through the Timers Tool (Index 16). 

From the Id List Window, the identifier list can be viewed directly. In 
order to add an identifier, the Add button is depressed. A pop-up window is provided 
to add the identifier to the list. The new identifier is accepted locally through the OK 
button. The addition of an identifier to the Id List is depicted in Figure 38. A similar 
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Figure 37. Identifier List Editor Component 

process applies to the editing of an existing identifier. However, in the case of editing 
an identifier, the identifier must first be selected. Otherwise an information message 
will be displayed to select an identifier first. In order to delete an identifier from the 
list, select the identifier and depress DELETE. Again, an information message will be 
displayed if an identifier is not first selected. 

Like the Text Window, initially, all changes made within the Id List 
Window are local. In order to modify the prototype, the changes must be accepted. 
This is accomplished by depressing the OK button. Changes may be aborted by 
depressing the Cancel button. 

4. Display Indications 

Under the Indicator column of Table XIII, the various methods used to display 
data are identified. Where practical, data objects are displayed within the window. 
However, due to the limited space within a window, it is not always possible to display 
the entire value of a data object. An effort was made to indicate to the user where 
data is available. This is not universal, in that the tool buttons have no indication of 
the existence of data. 
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Figure 38. Adding to an Identifier List 



As for the data flow diagram, it is visible in the Drawing Window. However, 
in order to view all attributes of the data flow diagram, the stream and operator pop- 
up windows must be accessed. The only method available to view the entire prototype 

is through the PSDL code generated by the PSDL Editor. 
a. Data 

A Data indication can be viewed directly from its Data or Display Only 
component. The user can scroll within the data window through the use of the left 
and right arrow keys. 
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b* QiiOir * • 

The Data... indication is similar to the Data indicator. However, in 
this case, the data value is typically much larger than the display window. If the data 
value will not fit within the window, the data value is truncated and a set of epsilons 

(i.e., “...”) is appended. Use the control mechanism to access the entire data value. 

c. Enumeration 

The current Enumeration value is indicated directly on the control com- 
ponent. 

d. Label 

A Label indication is similar to an Enumeration indication in that any 

feedback is provided directly on the control component. 
e» I/abel* * • 

In this Ccise, much like the Data... indication, a set of epsilons (i.e., 

“...”) is appended to the label to indicate that a data value is associated with the 

control component. Without the epsilons, a value has not yet been assigned. 

/. Hidden 

Not all data objects are available in all situations. Some data objects 
are context depended. For example, a state stream initial value is not relevant unless 
the stream is a state stream. As a method of enforcing PSDL semantics, several 
components are displayed based on the context of the operator/stream. The Hides 
column of Table XIII indicates those components which may be unavailable due to 
context. Figure 39 depicts the case of a stream which is not a state stream. Here, 
the State Initial Value Control (Index 51) is “grayed out” and the State Initial Value 
Display (Index 52) have been removed. In contrast. Figure 34 depicts a state stream 
in which both of these components are available. 

5. Cursor Types 

Several different types of cursors are used within the PSDL Editor. The default 
cursor is the left pointer. It is used for selecting components as described above. 
Within the Drawing Window, an I-Bar cursor is displayed when the cursor is over 
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Figure 39. Hidden Components 

an object (i.e., data stream or operator). The I-Bar cursor over the data flow diagram 
is used to indicate to the user that a label can be typed in directly. Finally, a clock 
face cursor is used to indicate that the PSDL Editor is busy. The clock face cursor is 
typically encountered when a syntax check or a prototype save function is performed. 
More will be said regarding the I-Bar cursor in the Data Flow Diagram paragraph 
below. 

6. Mouse Interface 

The PSDL Editor requires a two button mouse. The left-mouse button is 
used to access most functions. The right-mouse button is used to pull up the Stream 
Property or Operator Property pop-up window, as required. This is accomplished by 
placing the cursor over the object in question within the Drawing Window and 
depressing the right-mouse button. Again, more will be said about mouse interaction 
in the Data Flow Diagram paragraph below. 
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Table XIV. PSDL Editor Hot Keys 



Function 


Menu 


Control-key 


Diamond-key 


Go TO Root 


PSDL 


CTRL-R 


<^-R 


Go TO Parent 


PSDL 


CTRL-P 


<C>-P 


Decompose 


PSDL 


CTRL-D 


0 -D 


Refresh Display 


Edit 


CTRL-F 


0 -F 



7. Hot Keys 

Access to selected menu functions is available through Hot Keys. Those menu 
items with Hot Keys are identified by an underscore under the Hot Key letter in the 
pull-down menu (reference Figure 31). Table XIV lists the menu functions, along 
with the associated key sequence, which are defined Hot Keys. 

B. PSDL MAPPING 

As was discussed in Chapter III, the PSDL Editor focuses the user on one 
operator at a time. Figure 40, similar to Figure 21 from Chapter III, indicates 
the general mapping of the PSDL Editor into the prototype. The PSDL graphical 
user interface focuses the user on the current operator. There are two exceptions, 
the Types Tool provides for the specification of abstract data types, at the root 
level, and the Operator Properties pop-up window supports the functionality of child 
operators. The background checker provides for the generation of redundant code in 
order to complete the operator’s specification construct. 

C. PSDL EDITOR OPERATION 

The PSDL Editor is operated through the use of Menu and Tool Bar func- 
tions and pop-up windows. Upon creating a new prototype, the user must start at 
the root level. Abstract data types may be entered through the Types Tool at 
any time. However, the specification of the hierarchical tree used to implement the 
prototype must be performed top-down. That is, the structure of the hierarchical 
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Figure 40. Editor to PSDL Mapping 
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tree must be specified, starting with the root and proceeding down to the leaves. De- 
velopment of the prototype in this top-down fashion maintains a syntactically correct 
prototype. If a bottom-up approach was provided, the prototype would no longer be 
syntactically correct at each stage of development. The detailed implementation of 
each operator can be specified in any order. 

The network used to implement each PSDL operator is specified within the 
Drawing Window, using the tools provided in the Tool Bar. Implementation 
details for each composite operator and stream can be entered through pop-up prop- 
erties windows. Navigation tools are provided to traverse the hierarchical tree. Any 
time you are using an editor, frequent saves are recommended, which may be accessed 
through the Menu Bar. 

Finally, if help is needed, the PSDL Editor provides help windows, both at the 
Main Window as well as for pop-up windows. Help is accessed through a text window, 
as illustrated in Figure 41, with scroll bars available for browsing the message. Press 
the OK button to exit help. 

1. PSDL Editor Segment Synchronization 

The PSDL Editor consists of two segments, the background checker and the 
graph editor, which operate in unison. Each segment performs a portion of the 
editing task. The background checker is responsible for the input parsing of the 
PSDL prototype, extracting operators out of the prototype for processing by the 
graph editor, global syntax and semantic validation, and the generation of PSDL 
code. The graph editor is responsible for providing a graphical user interface which 
is used to edit /view the prototype, one operator at a time. The entire prototype is 
maintained within the background checker. At most one operator can be processed by 
the graph editor at a time. It is the responsibility of the background checker to accept 
the operator inputs from the graph editor and to assemble them into a prototype. User 
directed changes to the prototype are introduced in the graph editor. The background 
checker automatically resolves the implications of the graph editor produced changes 
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Figure 41. Help Windows 



with the prototype. In the event that a discrepancy can not be resolved, an error 
message is fed back to the user. 

The flow of information between the two PSDL Editor segments was depicted 
in Figure 17 of Chapter III (see page 43). After processing of the prototype, the back- 
ground checker passes control, along with those objects described in ge.interface.h 
(reference Appendix D, page 195), to the graph editor. At which point the user is 
allowed to edit the current operator. All editing of an operator is local to the graph 
editor. Specific events, requested by the user, result in control being passed back to 
the background checker. During these events, the background checker synchronizes 
the prototype with respect to the graph editor. Synchronization is controlled by the 
ACTION data structure of ge_interface.h. The ACTION data structure also specifies 
if control is to be returned to the graph editor along with the next operator to be 
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Table XV. Synchronization Events and Actions 



Button/Option 


Located on 


Action 


Check Syntax button 
SAVE REQUIRED button 
Save option 

Restore From Save option 
Exit option 
Syntax Check option 
Go TO Root option 
Go TO Parent option 
Decompose option 
Abandon Changes option 


Status Bar 
Status Bar 
File Menu 
File Menu 
File Menu 
PSDL Menu 
PSDL Menu 
PSDL Menu 
PSDL Menu 
Edit Menu 


CHECK-SYNTAX 

SAVE-TO-DISK 

SAVE-TO-DISK 

REVERT 

SAVE-T0J3ISK or ABANDON 

CHECK-SYNTAX 

UPDATE-TREE 

UPDATE-TREE 

UPDATE-TREE 

ABANDON 



processed. 

The users requested events which result in the synchronization of the back- 
ground checker and the graph editor are listed in Table XV. Associated with each 
synchronization event, is an action. Actions are also defined in ge.interface .h. 

•UPDATE-TREE synchronizes the graph editor operator with the prototype main- 
tained by the background checker. No validation is performed. 

•CHECK-SYNTAX synchronizes the graph editor operator with the prototype main- 
tained by the background checker. Syntax and semantic validation is per- 
formed. 

•SAVE_TO_DISK synchronizes the graph editor operator with the prototype main- 
tained by the background checker. Syntax and semantic validation is per- 
formed. The prototype is saved to a file. 

•REVERT synchronizes the graph editor with the prototype version which resides 
on disk (i.e., version that was last saved). 

•ABANDON synchronizes the graph editor with the prototype residing in the back- 
ground checker memory. Only changes made since the last time the prototype 
was synchronized are abandoned. 

2. Data Flow Diagram 

The data flow diagram is specified in the Drawing Window. The PSDL 
Editor provides a simple drawing package, used to create/maintain the data flow 
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Figure 42. Data Flow Diagram Symbols 

diagram. Only a small set of drawing objects are required to represent the data 
flow diagram. Several variations to objects, such as color and font, are provided to 
improve the readability of the data flow diagram. These variations have no effect 
on the operation of the prototype, only on the visual representation of the data flow 
diagram. 

a. Symbols 

The data flow diagram consists of a network of operators, connected 
through streams. Operators and streams are the only objects which are represented 
in the data flow diagram. Figure 42 depicts all of the symbols which are available to 
the user. 

Chapter II introduced the distinction between operators which are con- 
sidered to be part of the prototype system and those which reside outside the system. 
Those operators which reside outside the prototype system partition were specified 
by assigning a maximum execution time of zero and were called Terminators. Within 
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the PSDL Editor, Terminators are symbolized by rectangles. All other operators are 
symbolized by circles. Each PSDL Operator, including Terminators, can be imple- 
mented either as a composite operator or as an atomic operator. Atomic operators 
being implemented using a PSDL supported programming language, composite oper- 
ators being implemented themselves by a network of PSDL operators. All composite 
operators are designated by a double boarder in the PSDL Editor, a double rectangle 
for composite terminators and a double circle for composite operators. In addition 
to the operator symbol, the data flow diagram is annotated with the operator name 
and the maximum execution time, as available. 

Chapter II also introduced the distinction between streams and state 
streams. Streams are symbolized by a directed line, state streams by a wider directed 
line. In both cases, the direction of information flow is indicated by the arrow. 
Streams and state streams are again annotated with the stream name along with any 
latency value, as available. 

The bottom of Figure 42 depicts the implementation of a composite 
operator. Streams into and out of a composite operator become external streams 
within the composite operator’s implementation. Such streams are designated with 
a source or destination of External. Once again, the direction of information flow is 

indicated by the arrow. 

b. Drawing 

The data flow diagram is created by selecting a drawing tool from the 
Tool Bar and positioning the object in the Drawing Window. The drawing tool, 
once selected, remains selected until another drawing tool is picked by the user. This 
allows the user to position as many copies of that object in the Drawing Window as 
desired. Specifically, the following procedures are used create the data flow diagram. 

•Operators are added by first depressing and releasing the left-mouse button 
over the desired Operator/Terminator Tool to select the tool. Then, 
positioning the cursor over the desired operator/ terminator location and de- 
pressing and releasing the left-mouse button. Repeat for additional opera- 
tors/ terminators. 
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Figure 43. Construction of a Stream 



•Streams are added by first depressing and releasing the left-mouse button over 
the Stream Tool to select the tool. Streams, unlike operators, are created 
with a sequence of points. At least two points are required to establish a source 
and destination. Other points can be added to route the stream around other 
objects on the Drawing Window. The stream source is always the first 
point selected. The stream destination is always the last point selected. Start 
the stream by positioning the cursor over the source operator and depressing 
and releasing the left-mouse button. Streams start and finish at the middle 
of an operator. There is no need to precisely position the cursor when se- 
lecting the source or destination. Route the stream using intermediate points 
by depressing and releasing the left-mouse button over each location. As the 
stream is built, it is represented with dashed line segments between anchor 
points. Anchor points are represented as small black squares, indicating an 
intermediate point. A stream under construction is depicted in Figure 43. 
The stream is finalized by positioning the cursor over the destination operator 
and depressing and releasing the left-mouse button. The resulting stream is a 
smooth curved line with an arrow at the destination, as depicted in Figure 44. 
There is no requirement to provide intermediate points within a stream. How- 
ever, the PSDL Editor does not provide for the addition of intermediate points 
to a completed stream. Instead, the stream must be deleted and replaced. It 
is recommended that streams incorporate at least one intermediate point to 
provide for future routing changes. 

•For composite operators, other than the root operator, inputs and outputs 
of the composite operator are represented as externals within the data flow 
diagram. External streams are similar to the streams above, except that they 
are missing either a source or destination operator. For an external source, 
position the cursor over the desired “source” location and depress and release 
the left-mouse button. Continue the stream as discussed above. For an ex- 
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Figure 44. Completed Stream 



ternal destination, start the stream as discussed above. In order to complete 
the stream, position the cursor over the desired “destination” location and 
double-depress and release the left-mouse button. Care must be taken that 
the mouse does not move during the double button press. Otherwise, addi- 
tional intermediate points will be created. The completed external stream is 
as represented in Figure 42. 

•It the user chooses to abort a stream while in the construction process, the 
Escape (Esc) can be used to cancel a stream up until completion. 

•Stream and operator labels can be added directly from the Drawing Win- 
dow. Position the cursor over the object which is to be labeled. Once over 
the object, the left pointer cursor will be replaced with an I-Bar cursor. At 
this point, the user, can type the label. The label must correspond to a valid 
identifier for the object. If the cursor is moved during the process of typing 
the label, the PSDL Editor will assume that you are restarting the label and 
erase the what has been entered. 

•At any time, depressing and releasing the right-mouse button over an object 
will access the appropriate pop-up window. After entering the desired data 
into the pop-up window, depress the OK to accept the data. 

•In order to create a composite operator, the operator must first be selected. 
This is accomplished by positioning the cursor over the SELECT Tool and 
depressing and releasing the left-mouse button. Next, position the cursor over 
the desired operator and depress and release the left-mouse button to select. 
The data flow diagram for the composite operator can then be accessed by 
selecting the DECOMPOSE option from the PSDL Menu. 

•Several of the PSDL Editor functions require the selection of an object. An 
object is selected through the use of the Select Tool, which is activated by 
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Figure 45. Selected Operator 



depressing and releasing the left-mouse button while the cursor is located over 
the Select Tool. Objects can then be selected by locating the cursor over 
the desired object and depressing and releasing the left-mouse button. As an 
indication that an object has been selected, the anchor points for that object 
are displayed, as illustrated in Figure 45. 

•In order to deselect an object, depress and release the left-mouse button over 
any white space in the Drawing Window. 

•Both operators and streams can be deleted from the data flow diagram. The 
procedure is the same for both operators and streams. Using the selection 
procedure described above, select the desired object. The object can then be 
deleted by the Delete key from the keyboard. If an operator is deleted, then 
all associated streams will also be deleted. If a stream is deleted, only that 
stream will be deleted. 

•The PSDL Editor provides the facility to undelete an operator. The undelete 
operator feature is selected from the Edit Menu. Selecting this feature access 
a pop-up window which contains the names of all deleted operators. Undelete 
the desired operator by locating the cursor over the operator name and double- 
depress the left-mouse button. This operation can be somewhat confusing in 
the event that un-named operators are deleted. Such operators show up in 
the names of deleted operators as a blank lines. However, the same procedure 
still applies. When an operator is recovered, all associated streams are also re- 
covered. Recovery of deleted operators is available from the time the operator 
is deleted up until the time that the graph editor passes control back to the 
background checker. Once control is passed back to the background checker, 
all deleted operators are purged. If deleted operators are being maintained by 
the PSDL Editor when control is passed back to the background checker, the 
user is required to acknowledge that the deleted operators, together with the 
corresponding portions of the hierarchical tree which resides under the deleted 



95 



operators, will be purged. The user can select OK to purge or the user can 
remain in the graph editor by selecting No or Cancel. 

•The PSDL Editor also provides the facility to abandon all the changes made to 
the PSDL operator since the last time the operator was synchronized with the 
prototype. This feature is accessed under the EDIT MENU with the Abandon 
Changes option. 

c. Graph Modifications 

Once the data flow diagram has been defined, there are several aspects 
of the diagram which can be modified to improve the readability of the diagram. 
These changes have no effect on the performance of the prototype, only on the visual 
representation of the data flow diagram. 

•Operators can be moved within the Drawing Window. The movement of 
graphics objects can only be accomplished when the Select Tool is active, 
as described in the previous section. Using the Select Tool, position the 
cursor over the desired operator. Depress and hold the left-mouse button. 
With the left-mouse button held, move the cursor to the desired location and 
release the left-mouse button. Labels will be moved with respect to the new 
operator location. Streams paths will be altered as one of the end points is 
relocated with the operator. None of the intermediate anchor points associated 
with a stream are moved. 

•Streams paths can also be changed in a similar manner. Select the desired 
stream, as previously described, to access the stream anchor points. Still 
using the STREAM TOOL, position the cursor over the desired anchor point 
and depress and hold the left-mouse button. With the left-mouse button held, 
move the cursor to the desired location and release the left-mouse button. The 
location of stream labels will be effected by the new location of the stream 
mid-point. 

•The size of an operator can likewise be changed through the use of anchor 
points. Select the desired operator using the SELECT Tool. Position the 
cursor over the anchor point, which is in the direction in which you wish to 
change the operator’s size, and depress and hold the left-mouse button. With 
the left-mouse button held, move the cursor to the desired location and release 
the left-mouse button. 

•All labels, both names and time values, can be relocated on the Drawing 
Window. The label must be selected as previously discussed. Depress and 
hold the left-mouse button with the cursor over the desired label. Position the 
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Figure 46. Relocating Operator Label 



cursor over the desired location and release the left-mouse button, as depicted 
in Figure 46. 

•If, in attempting to reposition a stream intermediate point or an operator, one 
of the associated labels is moved instead, make sure that the label is deselected 
prior to attempting to move the cursor. This may involve deselecting and 
reselecting the object. 

•As an aid to increase the readability of the data flow diagram, operators can 
be colored. Selecting COLOR from the EDIT MENU access a color pop-up 
window. This function can be utilized in two ways. First, the color of a 
specific operator can be changed by selecting the desired operator and then 
assigning a color from the color pop-up window. Second, the color to be used 
for future operators can be defined by deselecting all operators before accessing 
the color pop-up window and then selecting a color. 

•Fonts can likewise be changed from the Font option of th6 Edit Menu. 
Selecting the Font menu option access a font pop-up window very similar 
to the color pop-up window. The same two methods of operation for COLOR 
apply to Font. First, the font of a specific label can be changed by selecting 
the label prior to accessing the font pop-up window. Second, the font to be 
used for future labels can be defined by deselecting all objects before accessing 
the font pop-up window and then selecting a font. Note that this second mode 
of operation can not be used to change the font of an existing label by typing 
over the label with a new font. Instead, the font must be changed using the 
first method of operation. 
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Figure 47. Printer Pop-up Window 
d. Printing the Data Flow Diagram 

The current data flow diagram can be saved as an output image. This 
capability is accessed through the Print option of the File Menu, which presents 
a printer pop-up window (reference Figure 47). From the printer pop-up window, 
the image can be saved either to the printer or a file. If file is selected, the user can 
provide an optional printer name. Only the printer name should be provided in the 
data window. If no printer name is provided, the image is printed to the standard Ipr 
printer. The printer must be a PostScript^® printer. If an output file is selected, the 
data flow diagram is saved to a file using xwd, which produces an X Window System 
Dump File format. The file name must be provided. 

3. Navigation 

The graph editor is only capable of displaying/editing the data flow diagram of 
one PSDL operator at a time. Each prototype consists of a hierarchical tree of PSDL 
operators. The PSDL Editor provides facilities to traverse the hierarchical tree in 
order that the entire prototype can be viewed/edited. The mechanism to traverse the 
prototype is provided within the PSDL Menu. The options Decompose and Go 

^®PostScript is a trademark of Adobe Systems Incorporated 
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TO Parent are used to traverse up and down the hierarchical tree. Which branch of 
the tree is traversed, when going “down” the tree, is controlled by the operator which 
is selected in the data flow diagram. There is only one parent, and thus no option 
when traveling “up” the tree. A short cut. Go to Root, is provided to directly 
traverse to the root operator. All navigation menu items are equipped with a hot key 
to improve efficiency. Hot keys were identified in Table XIV. 

4. File Operations 

The PSDL Editor provides very simple file operations. Since the PSDL Editor 
is designed to work within the CAPS environment, there are no provisions for creating 
a new prototype or saving the current prototype under a different name. The PSDL 
Editor provides two basic functions, which are located under the File Menu: Save 
and Restore From Save. A short cut button, labeled SAVE REQUIRED, is 
provided on the Status Bar. This button is context sensitive to the status of the 
prototype. If the prototype has not been modified, the button is labeled Save Not 
Required. Save does just that, saves the prototype to disk. Restore From Save 
abandons all changes made to the prototype since the last save operation and reverts 
back to the last saved version. The user will be required to acknowledge that all 
changes will be lost. Upon completion of the restore operation, the user is returned 
to the root operator. The save operation will return the user to the original PSDL 
operator. 

The user exits the editor from the File Menu using the Exit option. If 
required, the user will be prompted to save the prototype. In addition, the user will 
be informed that all deleted operators will be purged. 

Instead of abandoning all changes made to the prototype since the last save 
command, the user can abandon the changes made to an operator since the last time 
the operator was synchronized with the prototype. The Abandon Changes option 
is available under the Edit Menu for this purpose. 
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Figure 48. Graph Editor Detected Error 



5. Syntax/ Semantics Checking 

Syntax and semantic validation tests are distributed throughout the PSDL 
Editor. Most syntax errors and and a few semantic errors are detected by the graph 
editor. The graph editor performs syntax and semantic validation upon entry of 
each data object, typically before the data object is written to the editor’s internal 
representation of the prototype. Errors detected by the graph editor are reported with 
an information pop-up window, which must be acknowledged. An error indication is 
also provided in the Status Message Window, reference Component 9 in Figure 32, 
which serves as a reminder after the pop-up window has been acknowledged. 

Figure 48 is an example of an error detected by the graph editor. In this 
example, the operator name op_a is being reused for the new operator in the same 
data flow diagram. Since op_a has already been used within the composite operator. 
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Table XVI. Invoking Syntax/Semantic Validation 



Check Syntax button from Status Bar 
SAVE REQUIRED button from Status Bar 
Save option from File Menu 
Restore From Save option from File Menu 
Syntax Check option from PSDL Menu 
Abandon Changes option from Edit Menu 



an error message is generated. Upon acknowledging the pop-up notice, the Status 
Message Window will be retained until the next user operation. In this instance, 
the PSDL Editor automatically removes the duplicate name from the operator, in 
order to maintain a valid PSDL prototype. Had the error occurred during entry of 
the operator name from the Operator Property pop-up window, the invalid operator 
name would not have been removed. Since changes to the operator from the Operator 
Property pop>-up window will not be accepted until all errors have ben resolved, the 
name is retained so that the user can correct the error. 

Other validation checks can only be performed from a global perspective. 
These errors can only be detected by the background checker. While the graph 
editor performs validation upon data entry, the background checker can only vali- 
date the prototype when the prototype is synchronized with the graph editor and the 

background checker is passed control. 

a. Invoking Syntax/ Semantic Validation 

Syntax and semantic validation by the background checker is performed 
whenever possible. In order to improve the responsiveness of the PSDL Editor, valida- 
tion is not performed every time that the editor is synchronized. Table XVI identifies 

all user action which invokes the background checker to perform validation checks. 
h. Error Messages 

Upon returning command to the graph editor, any errors detected by 
the background checker will result in the Check Syntax button being replaced with 
the ERROR MSGS button on the Status Bar. By selecting this button, an Error 
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Messages pop-up window will be presented, as depicted in Figure 27. Within the 
Error Messages pop-up window, the user can select an error message and directly 
go to one of two operators associated with the error. The Current operator is the 
operator in which the background checker detected the error. The Parent operator is 
relative to the operator in which the error was detected. 

6. PSDL Output 

The output of the PSDL Editor is the PSDL code, which implements the 
prototype. An example of PSDL code is provided in Appendix B. Identifiers in 
the PSDL code differ from those observed in the PSDL Editor, with the addition of 
suffixes in the PSDL code. Hard copies of an operator’s data flow diagram can be 
obtained from the PSDL Editor through the use of the Print function under the 
File Menu (reference Figure 31). 
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V. 



IMPLEMENTATION 



The PSDL Editor has been a team effort. The architecture of having two 
programs (i.e., the background checker and the graph editor) work together to provide 
an integrated editor facility immediately lends itself to a team development. Professor 
Man-Tak Shing was responsible for this version of the background checker. The 
focus of this research has been the graph editor along with the integration of the 
two programs. Reference Appendix D for a listing of the complete graph editor 
source code. The source code for the background checker is not available in this 
document. However, it is available from the CAPS Research Team at the Naval 
Postgraduate School, Computer Science department. Appendix E provides guidelines 
for the installation of the PSDL Editor. 

A. ARCHITECTURE OVERVIEW 

The PSDL Editor architecture is characterized as having two programs, exe- 
cuted in separate processes, which share information through interprocess channels. 
The background checker provides the facilities for all file processing, input parsing of 
a PSDL prototype, syntax and semantic validation of the prototype, and PSDL code 
generation. The graph editor provides a graphical user interface and facilitates the 
viewing and editing of the PSDL prototype. Localized syntax and semantic validation 
is also performed by the graph editor. 

1. Program Evolution 

The current architecture of the PSDL Editor is the result of an evolution 
process. The CAPS Release 1 PSDL Editor was the baseline from which this research 
was initiated. Much of the new design is the creation of Professor Man-Tak Shing, 
who utilized the PSDL Editor as the class project in re-engineering of a software 
engineering tool. The results of this class project were then expanded upon to produce 
this research effort. 
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a. 



CAPS Release 1 PSDL Editor 



The CAPS Release 1 PSDL Editor was developed by Captain Robert 
Dixon, USMC [Ref. 13]. Captain Dixon’s version of the editor was implemented 
as two programs, the syntax-directed editor and the graph editor. Data was shared 
between the two programs using two files. Figure 49 illustrates the architecture used 
to implement the PSDL Editor. The two files supported the limited data sharing 
required for the data flow diagram. The first file, gedatatrainsf ile .txt, was used to 
import the data flow diagram into the graph editor as well as to make intermediate 
saves. The second file, gedatatrajisfile2.txt, was used to export the data flow 
diagram back to the syntax-directed editor. A special file, gedatatransf ile. lock, 
was used to protect the files in case multiple copies of the PSDL Editor were executed 
in the same directory space. 

Within the graph editor, the C-h+ class GraphObjectList was used 
to represent the data flow diagram. Captain Dixon’s thesis [Ref. 13], describes the 
class structure used by the graph editor. The data flow diagram itself is represented 
as a linked list of operator and stream objects. The common features of both of 
these objects are grouped together in the base class GraphObject, from which the 
OperatorObject and StreamObject classes are derived. This class structure is de- 
picted inside the graph editor process of Figure 49. 

Upon execution of the graph editor, the representation of the data 
flow diagram was read from gedatatraiisfile.txt into the GraphObjectList data 
structure by build_from_disk(). Upon returning to the syntax-directed editor, 
write_to_disk() was used to write the GraphObjectList data structure into the 
file gedatatransfile2.txt, to be read by the syntax-directed editor. 

A command line argument was used by the syntax-directed editor to 
indicate if the graph editor was to be executed as a data flow diagram viewer or an 
editor. The same program was used for both applications. 

Most of the code used to facilitate the data flow diagram was used 
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Graph Editor Process 




Figure 49. CAPS Release 1 PSDL Editor Architecture 
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directly to support this research effort. Enhancements were made to provide for 
the direct entry of operator and stream labels. In addition, an abort was added 
to the stream creation process. The two files used to share information between the 
syntajc-directed editor and the graph editor were eliminated, along with the associated 
methods which supported the reading and writing of data to these files. The class 
structure was maintained. Additional fields and methods were added to the classes 

in order to support the full specification of a PSDL operator. 

6. CS 452 O Class Project 

Professor Man-Tak Shing introduced the PSDL Editor as the class 
project for the Naval Postgraduate School course CS4520 (AY96Q4). CS4520 is 
a topical software engineering class. This particular class dealt with software re- 
engineering. The goal of the class project was to re-engineer the PSDL Editor to 
provide a more user-friendly editing facility. Only the graph editor was evaluated as 
part of the class project. 

In addition to implementing a new user interface, the new graph editor 
was to be implemented as a C+-I- function. All data to be shared between the back- 
ground checker and the graph editor was to be passed as arguments in the function 
call. Although only the graph editor was being implemented, the new graph editor 
was to be integrated with the syntax-directed editor in a single process. 

The interface which was used to pass data between the background 
checker and the graph editor was defined by ge_interf ace . h. Data structures defined 
in ge.interf ace .h expanded upon the data transfered by gedatatransfile.txt, 
used in the CAPS Release 1 PSDL Editor. Within the graph editor, the original 
GraphObjectList class structure was maintained. Methods were developed to trans- 
fer data between the ge_interf ace .h data structures and the GraphObjectList class 
structure. These methods replaced the build_from-disk() and write_to_disk() 
methods used in CAPS Release 1. 

Upon completion of the CS4520 class projects. Professors Valdis Berzins 
and Man-Tak Shing reviewed all the projects. The project produced by Mr. Douglas 
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Lange and Mr. Dagohoy Anunciado was chosen to be used for continued research of 

the CAPS PSDL Editor. 

c. Thesis Research 

Picking up from the work initiated by Mr. Douglas Lange and Mr. 
Dagohoy Anunciado, the completion of the graphical user interface was accomplished 
for the graph editor, along with implementing addition features. Initially, all work 
on the graph editor was accomplished in a stand-alone fashion, using a simulated 
background checker driver program. Later, the graph editor was integrated with 
the background checker. The background checker was created by Professor Man-Tak 
Shing, using the Synthesizer Generator. The result was an Ada/C program, which 
was used to call the C-f-l- routine that was the graph editor. 

Figure 50 provides a visualization of the PSDL Editor architecture. The 
PSDL Editor consisted of a single process. The background checker would read the 
specified PSDL prototype from a file and parse the prototype into the prototype data 
structure. The current operator would be extracted from the syntax-directed editor 
data structure and formatted in accordance with the ge.interface.h specification. 
This data would be passed as arguments to the graph editor function. Inside the 
graph editor routine, the current operator was loaded from the ge_interf ace .h data 
structures into the GraphObjectList class structure (as depicted inside the graph 
editor process of Figure 49). Upon exiting the graph editor, the process was reversed. 
The GraphObjectList class structure was dumped into the ge.interface .h data 
structures, which were dumped into the prototype data structurefor processing. 

While development of the graph editor continued, testing was con- 
ducted as an integrated unit. X Window System problems were encountered while 
executing the background checker and the graph editor within a single process. These 
problems were not observed while executing the graph editor with a simulated back- 
ground checker driver program. 

Additional complications were encountered while troubleshooting the 
system. With the background checker being implemented in Ada and C and the 
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Figure 50. Initial PSDL Editor Architecture 



108 



graph editor being implemented in C++, difficulties were encounter using the source 
debuggers. Finally, errors reported within the X Window System routines could not 
be traced since there was no source code for the X Window System. This configuration 
resulted in difficulty troubleshooting all problems with the editor, typically using 
output statements to debug the program. 

These problems were resolved by once again splitting the PSDL Editor 
into two segments, the background checker and the graph editor, executed in two 
separate processes. This configuration also supported the source debuggers, which 
were a great aid to the development of the PSDL Editor. 

Figure 51 provides a visualization of the final PSDL Editor architecture, 
in which the graph editor is executed in a separate process. The background checker is 
responsible for forking a child process and establishing the pipe lines for interprocess 
communication. Within the background checker, the graph editor routine has been 
replaced with calls to transfer the ge.interface.h data structures to the graph editor 
process. A driver ge.driver.C routine was added to the front of the graph editor. 
This routine is responsible for accepting the ge.interface .h data structures over 
the interprocess communication pipe line and passing them onto the graph editor 
routine. Upon exiting the graph editor routine, the ge.driver . C routine passes the 
ge.interf ace .h data structure back to the background checker. 

Early testing of the PSDL Editor was accomplished using a small pro- 
totype. This prototype was filled with PSDL features, which tested most of the PSDL 
Editor, however, it was not a very stressful test. Later, additional testing was accom- 
plished using a medium size prototype. Upon testing with the avionics.example 
prototype, found in Appendix B, problems were encountered. The initial problem, 
which was obvious to any user, was the delays encountered while using the PSDL 
Editor. Where one of the initial complaints of the CAPS Release 1 PSDL Editor was 
the delays between interacting with the syntax-directed editor and the graph editor, 
the new implementation had even longer delays. Delays from 30 to 45 seconds were 
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Background Checker Process 












Figure 51. Final PSDL Editor Architecture 
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typical when navigating through the avionics.example. 

Prolonged use of the PSDL Editor resulted in the second big problem, 
the system ran out of memory. In such a case, the PSDL Editor session had to be 
aborted. All unsaved changes to the prototype were lost. These problems are further 
defined under the Lessons Learned paragraph of Appendix B. 

Analysis of the PSDL Editor indicated that both the delay and the 
memory problems were due to the background checker. These problems, as well as the 
desire to increase portability by removing the reliance on the Synthesizer Generator, 
resulted in the development of the new Ada background checker. 

2. Architecture 

The PSDL Editor, in its final configuration, consists of two segments, the 
background checker and the graph editor. As depicted in Figure 51, each segment 
is executed within its own process. Communication between the two segments is 
accomplished using Unix pipes. Two pipes are opened to provide bi-directional com- 
munication between the two processes. Input to the PSDL Editor consists of a single 
file containing the PSDL prototype. Output of the PSDL Editor is also a single PSDL 
file. All user interaction is performed through the graphical user interface provided 
by the graph editor. The graphical user interface is implemented as an X Window 
System application using the Motif widget set. Communication between the two 
processes is based upon the ge_interface.h data structures. 

3. Data Communications 

The interface between the background checker and the graph editor supports 
the bi-directional transfer of PSDL data. In addition, errors detected by the back- 
ground checker are transfered to the graph editor. While the graph editor commands 
the background checker to perform the next action. All interprocess communication 
is defined by the file ge_interface .h. Along with the data structures to support the 
above communications, ge.interf ace . h provides common definitions. 
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a. Graph Description 

The structure GRAPH.DESC provides all of the information regarding 
the prototype required by the graph editor. Only one operator is processed by the 
graph editor at a time, although some global prototype information is shared. The 
GRAPH_DESC structure represents the operator’s data flow diagram as a linked list of 
OPERATOR structures as well as a linked list of STREAM structures. The GRAPH_DESC 
structure is used in bi-directional communication with the background checker and 

the graph editor. 

b. Error Messages 

Errors detected by the background checker can only be presented to 
the user through the graphical user interface provided by the graph editor. The data 
structure ERROR-MSGS is a linked list of error messages, along with associated opera- 
tor and parent operator identification. If no errors are detected by the background 

checker, a NULL pointer shall be provided to the graph editor. 

c. Next Action 

The data structure ACTION provides the background checker with the 
commands required to determine the next action to take. Instruction is provided on 
how to synchronize the data contained within GRAPH_DESC with the prototype data 
structure, maintained by the background checker. Also provided are instructions on 
returning to the graph editor with the desired current operator. 

4. Synchronization 

Within the graph editor, all changes to an operator are local to the graph 
editor. Local changes are synchronized with the prototype maintained by the back- 
ground checker upon specific user requested events. The synchronization, along with 
the user specified event, were listed in Table XV of Chapter IV. All synchronization is 
a function of the background checker. A distinction was made between UPDATE.TREE 
and CHECK-SYNTAX as a concession to performance. Initially, syntax validation was 
performed with each synchronization event. However, large delays to perform syn- 
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Background Checker Process 




Figure 52. Background Checker Synchronization 



tax validation made this option unattractive for all synchronization events. Thus, 
UPDATE_TREE was added as an option, in which the prototype data structure, main- 
tained by the background checker, were synchronized with any modifications made 
in the graph editor, but with no syntax validation. This option was provided to im- 
prover performance while navigating the prototype. Figure 52 illustrates the type of 
processing which is expected to be performed by the background checker based on 
the synchronization command. 

B. GRAPH EDITOR DATA STRUCTURES 

Within the graph editor, the GraphObjectList class structure is used to main- 
tain all PSDL data. Captain Dixon described this structure in his thesis [Ref. 13]. 
This class structure has been maintained with this release of the PSDL Editor. A 
class diagram of the GraphObjectList structure was provided within the graph editor 
process box of Figure 49. 

All information contained within GRAPH_DESC, from ge.interface.h, which 
does not relate to the data flow diagram was appended to the GraphObjectList 
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class. Changes were made to all classes that incorporated a time literal. In the CAPS 
Release 1 PSDL Editor, time literals were encoded as signed integers. All time values 
in microseconds were encoded as negative times. Values in milliseconds were encoded 
as positive times. In order to support all time units defined in the CAPS Release 2 
PSDL grammar, time literals were maintained with two symbols. One maintained 
the time value, the other maintained the time units. 

Data flow diagram representation information was appended to class objects 
OperatorObject and StreamObject as applicable. Label and time values, displayed 
on the data flow diagram, for both operators and streams were modified to function as 
offsets from the graphics object. Previously, labels and time values were recorded at 
absolute locations. Methods were added to support the ge.interf ace .h structures. 

C. UTILITIES 

Several sets of utilities files were created in the process of developing the PSDL 

Editor. 

1. Graph Editor Utilities 

The files ge.utilities.h and ge.utilities . c provide a set of routines for 
dealing with components of the PSDL Editor. These files were written in C in order 
to support both the graph editor as well as the original syntax-directed editor (which 
was written in C due to the Synthesizer Generator). Primarily, the routines in these 
files support the maintenance of the data structures defined in ge.interf ace . h. The 
routine dup.strO is used throughout the PSDL Editor. This routine is used to make 
a deep copy of a string. In general, the PSDL Editor is implemented using deep 
copies. Shared values have been avoided. 

Another facility provided by the ge.utilities routines is the validation of 
PSDL constructs. These routines are used by the graph editor to validate identifiers, 
operator identifiers, type names, keywords, and integer literals. 
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Table XVII. Inter-Process Communication Routines 



readActionO writeActionO 
readErrorMsgsO writeErrorMsgsO 
readGraphDescO writeGraphDescO 



2. Inter-Process Communication 

The inter-process communication package was designed to accept the data 
structures defined by ge.interface.h at one end and recreate the same data struc- 
tures on the other end. These communication facilities are provided by the routines 
in the files inter.process.utilities .h and inter_process_utilities.c. Once 
again, these files were written in C to support both the background checker and the 
graph editor. 

The inter-process communication facility is provided by six routines listed in 
Table XVII. These routines operate on a xfer.buffer. The xfer .buffer is allowed 
to expand, doubling in size each time, in order to support the largest data structure. 
The xfer .buffer itself is sent over Unix pipes in packets with a maximum size of 
4096 bytes. 

The pipe lines used to facilitate inter-process communications are established 
by the background checker upon creation of the graph editor process. Two pipe lines 
are opened, in order to provide bi-directional communication. The two channels to be 
used are passed to the graph editor as command line arguments. The file ge .driver . C 
is the mainO routine for the graph editor. This file processes the command line 
arguments containing the channel numbers. The code used to open the pipe lines is 
provided by the background checker. A sample of code used to facilitate this process 
may be found in the file sde.c, which is discussed below. 

3. Unique Identifier Generator 

The incorporation of unique suffixes for operators required a unique suffix 
generator. The files get.imique.id.h and get.unique.id. c provide this facility. 
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Once again, these files were developed in C in order to support both the graph editor 
and the background checker. This implementation uses a file named imique_id.dat 
from which to generate sequential integers. Future releases of the PSDL Editor shall 
utilize a data base to provide unique identifiers across a distributed development 
environment (reference Professor Berzins’ memo included as Attachment C). The 
current implementation is limited to the visibility of the imique.id . data file. 

4. Program Development Aids 

Several files used develop the PSDL Editor have been included within the 
source code for the graph editor. While not required for operation of the PSDL 

Editor, they may be useful for future development efforts. 

a. Driver Program 

The files sde.c, sde_simulator.h, and sde_simulator . c were devel- 
oped to perform stand alone testing of the graph editor. The file sde . c provides 
the mainO routine used to fork the graph editor in its own process as well as to 
establish communications. The sde_simulator files provide a hard-coded prototype 
which can be edited. Note that this driver program has not been designed to work 
interactively with the graph editor. The driver program does not contain the facilities 
to synchronize with the graph editor. 

While the source code for the background checker is not contained here, 
the file sde . c does provide an example of code used to fork the graph editor process 

and to establish communication pipe lines. 

b. Debug Routines 

In the process of integrating the background checker and the graph edi- 
tor, often there was a need to examine the data contained within the ge.interf ace .h 
data structures. A collection of routines provided in files ge_utilities_debug.h, 
ge.utilities.debug.c, and ge.interf ace.labels .h were developed to display and 
print to a file the contents of the ge.interface .h data structures. 
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D. GRAPH EDITOR 

The files used to implement the graph editor, roughly organized by function, 
are listed in Table XVIII. The graph editor routine which actually edits the prototype 
is edit_graph() , defined in graph-editor . C. This routine is called from ge.driver . C 
upon receiving the ge.interface.h data structure from the background checker. 
At every synchronization event, this routine is exited. Within edit.graphO, the 
Motif windows are initialized. Initialization is performed once, based on the symbol 
motif-initialized. After the initial entry, the Motif environment is assumed to 
exist. Motif data is maintained within global objects in order to provide persistence. 

Typically, a Motif application expects to pass control over to Motif until the 
program terminates. In order to support the PSDL Editor, the Motif control loop had 
to be maintained within the graph editor. The edit -graph () routine enters a loop 
which dispatches X Window System events until a synchronization event is selected 
by the user to exit the graph editor. 
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Table XVIII. Graph Editor Source Code Files 



Function 


Header File 


Code File 


Graph Editor 


graph-editor .h 


ge-driver . c 
graph-editor .C 


Definition Files 


ge_interf ace .h 
ge.def s .h 
resources .h 




Classes 


graph-object-list .h 
graph-Object .h 
operator-object . h 
Stream-Object .h 
spline-object .h 
f ont -table .h 


graph-object-list .C 
graph-object .C 
operator-object . C 
Stream-Object .C 
spline-object .C 
font-table . C 


Pop-up Windows 


operator-propertyjnenu . h 
stream-property-menu . h 


operator_property_menu . C 
stream-property-menu . C 


Window Utilities 


act i on-area. h 
build-option.h 
gettopshell .h 
postpopup.h 
report-errors .h 
setcursor .h 
timer_tool .h 
warning.h 
windows .h 


action-area. C 
build-option. c 
gettopshell . c 
postpopup. c 
report-errors . C 
setcursor . c 
timer-tool .C 
Wcirning.C 
windows . C 


Utilities 


ge-utilities .h 
inter-process-utilities .h 
get -unique -id . h 

sde-simulator . h 
ge-utilities-debug.h 
ge-interf ace-labels .h 


ge-utilities . c 
inter-process-utilities . c 
get-unique-id.c 
sde.c 

sde-simulator . c 
ge-utilities-debug. c 
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VI. CONCLUSIONS AND 
RECOMMENDATIONS 

Overall, this research was successful in the development of an improved PSDL 
Editor facility. While full graphical user interface support was not provided for all 
features of PSDL, sufficient portions of the language were supported to demonstrate 
the concepts of the improved interface. 

Since the aspects of the PSDL Editor addressed by this research primarily 
relate to human factors, any validation of the improvements made would have to 
be accomplished with a survey of users. Such a survey was not conducted as part 
of this research, so no conclusions can be stated regarding the effectiveness of the 
improvements. However, a few personal observations from experience obtained while 
testing the PSDL Editor can be made along with some recommendations for future 
research. 

A. RESULTS OF RESEARCH 

Based on personal experience with the PSDL Editor, I would submit that 
the artificial boundary between the syntax-directed editor and the graph editor has 
been significantly reduced. What remains of the boundary is the batch mode of 
operation when it comes to global syntax and semantic validation as well as any 
delays encountered switching between the two programs. While early versions of the 
improved PSDL Editor had significant delays, optimizations within the background 
checker have resulted in acceptable delay times, even for large prototypes. 

Use of pop-up windows to specify the details of an operator or stream has 
streamlined the development of prototypes. Immediate access to complete details of 
a data flow diagram object are now one button away. No longer are users compelled 
to complete the data flow diagram prior to entering any of the details, due to the long 
delays and steps required to access this data. Direct entry of operator and stream 
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labels has been a significant step in streamlining the development process. 

Previous problems encountered by users attempting to locate a construct 
within the syntax-directed editor should not be as prevalent with the use of pop-up 
windows. These problems, associated with a linear translation of the PSDL gram- 
mar, are reduced by the depiction of all options within the pop-up window. Options 
displayed in the pop-up window are consistent with the current configuration of the 
object. No longer must a user remember the ordering of PSDL constructs, they are 
visible to the user from the pop-up window. Ghosting of an option acts to remind the 
user of the availability of an option while the physical location of the options suggest 
dependencies between options. 

An improvement which should reduce the amount of lost work in the PSDL 
Editor was the simplification of file operations. All file save operations now write 
directly to the prototype file. There is no longer an intermediate file to which the 
editor saves the prototype, from which users have lost entire edit sessions due to 
a misunderstanding of the save procedure. The currently implemented file system 
should be intuitive to most users of personnel computer software. 

As previously mentioned, not all features of PSDL were implemented with 
the graphical user interface. Several features of PSDL were determined to be too 
complex for this initial implementation of the graphical user interface. These features 
included abstract data types, constraint options, expressions, and the specification 
interface. Although not supported by the graphical user interface, these features were 
not left unsupported. Text windows were provided within the graph editor for the 
specification of these constructs using PSDL. Being some of the more complex PSDL 
constructs, they are also some of the more advanced features. And while all these 
features are critical to the use of PSDL, they are most often used by more advanced 
users. The result is that the PSDL Editor provides sufficient capabilities to be utilized 
for prototype development by the average user. More advanced users can still utilize 
the PSDL Editor, however, they will require more knowledge of PSDL to access these 
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advanced features of PSDL. 



B. CRITIC OF RESEARCH 

As with any program, criticism can be made of the design and implementation. 
This program offers no exception. Discussed below are observations of problems 
in the design and implementation. I do not point a finger to any previous author 
of the PSDL Editor for problems with this release. All of the problems, both in 
design and implementation, were mine to address. What few problems were inherited 
from previous authors were most likely small problems which I have amplified in 
“improving” the program. But just as there was insufficient time to support all 
features of PSDL, there was insufficient time to address these “features” of the PSDL 
Editor. 

1. User Interface 

The mapping between the PSDL Editor’s graphical user interface and PSDL 
is not clean. For instance, the functionality of an operator’s specification is accessed 
through the pop-up window for a composite operator. This mapping does not support 
the root operator. 

The drawing operation of the data flow diagram is too slow. While there may 
be a tendency to coerce the user to maintain good programming practices and keep 
the data flow diagram simple, it should not be accomplished by aggravating the user 
with delays. The drawing of streams, and especially state streams, is extremely slow. 
The system is not usable, when executed remotely over phone lines. 

Associated with the delays involved with drawing the data flow diagram, the 
data flow diagram is too sensitive to change. Unintentional changes are typically 
made to the data flow diagram as the user attempts to navigate the prototype. In 
order to navigate through the prototype, the user must select an operator. If the user 
moves the mouse while the left-mouse button is depressed, the object will be moved 
and the user will have to wait for the data flow diagram drawing to be updated. 
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The pop-up facilities to modify an operator’s color or a label’s font as well as 
those used to recover a deleted operator are rudimentary. No provisions are made 
to indicate the currently selected color or font. No provisions are made to Ok the 
selection or to cancel the operation. The user is required to know how to select the 
item with a double mouse action as well as the current value, in case the user wishes 
to leave the value unchanged. No feedback is provided to the user to indicate that 
a color or font change is being performed on a specific object or the default value is 
being changed. The restoration of an unlabeled operator is a guessing game for the 
user. 

2. Implementation 

The PSDL Editor started out as two programs, executed in separate processes. 
As an update to the design, it was converted over to a single program, executed in 
a single process. Problems encountered with this configuration forced it to be split 
once more into two programs, executed in separate processes. Again, problems were 
encountered which forced a change to the design of the editor. This last change has 
seen the removal of the Synthesizer Generator produced background checker, to be 
replaced with an Ada version. With this latest change, no modification was made 
to the interface between the background checker and the graph editor. With the 
design changes which have occurred so far, maintaining two separate programs may 
be wise. However, at this point, two separate processes appears to be unnecessary. 
Associated with two separate processes is a lot of communication overhead which 
could be removed, thus simplifying the program. Combining the two tasks into one 
procedure would also improve the performance with respect to delays, thus further 
reducing the artificial boundary between the background checker and the graph editor. 

With the evolution of the graph editor, the program has become “messy”. The 
program has appeared to have lost any structure as new features are simply added. 
Global objects are used throughout the program to provide communication with the 
graphical user interface. Files have become much too large. The graph-editor .C 
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file, once printed, goes on for fifty pages. The draw routine alone is ten pages long, 
with far too many levels of indentation. Even simple maintenance to the program 
becomes complex and error prone with this absence of organization. 

Within the graph editor, a clean representation of data objects has not been 
maintained. Redundant data is maintained throughout the data objects. For in- 
stance, which graphical object is selected is indicated within the data structure for 
that object. Thus a house keeping process must be maintained to ensure that only 
one object is selected at at time, clearing all other selected objects. The result is that, 
occasionally, multiple graphic objects appear to be selected. The user is confused at 
this point. Only by selecting and de-selecting each object that appears to be selected 
can the indications be cleared up. 

C. RECOMMENDATIONS FOR FUTURE RESEARCH 

In the process of re-engineering the PSDL Editor, many additional ideas come 
to mind. Most of which are much too late to be incorporated into the design of 
the system. The following is a collection of ideas which should be used to stimulate 
thought for the next release of the PSDL Editor. 

The current design of the graphical user interface provides a very limited view 
of the context of an operator. The user is presented with the data flow diagram of 
the operator, but no visualization of the context of the operator. The CAPS Release 
1 PSDL Editor provided some indication of external streams. Even this limited view 
of context was removed from this release of the PSDL Editor. Future releases of 
the PSDL Editor should prompt the user with options available from the operator’s 
context. Figures 53 and 54 depict an initial attempt to provide the user with such a 
context with respect to streams. Figure 53 illustrates the user’s options of entering a 
stream name directly into the data entry window or to select from a list of predefined 
streams. Figure 54 depicts all streams which are currently defined in the context, 
along with an indication of external streams and their use, state streams and their 
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Figure 53. Stream Property Pop-up with Predefined Option 




Figure 54. Stream Predefined Context 
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initial value, and the stream type. Due to scheduling constraints, this option was 
never incorporated into the final release of the PSDL Editor. 

Options available for improved data flow diagram editing capabilities mostly 
involve modifications to streams. Such features as being able to remove or add inter- 
mediate stream anchor points as well as being able to change the direction of a stream 
would improve the user’s ability to modify an existing data flow diagram. Higher level 
edit features for working with operators would also greatly improve the user’s ability 
to modify a prototype. Such features would include the ability to select a group of 
operators from a single data flow diagram and form a composite operator from them, 
thus adding one more level to the hierarchical tree. The reverse operation could also 
be provided as a feature, to remove a level from the hierarchical tree. Copy, cut, and 
paste operations on selected operators could be provided. Modifications to object 
properties, such as color and font, could be performed on several selected objects 
simultaneously. 

Improved semantic validation capabilities could be incorporated. Possible can- 
didates include detecting cycles in data flow diagrams which are not broken by state 
streams and global validation of timing constraints. This release of the PSDL Editor 
took a step backward in editing an existing prototype. In order to edit a prototype, 
the editor must be able to parse the input file. Syntactical errors in the input file 
could result in the PSDL Editor not being able to parse the prototype. Previously, 
the PSDL Editor would at least allow the user to edit the prototype text if a syn- 
tactical error was detected. With this release, the PSDL Editor is not usable on a 
corrupted prototype. 

While the CAPS environment provides access to the complete set of CAPS 
tools, many of these tools could be integrated with the PSDL Editor. Tighter inte- 
gration of CAPS tools could provide; 

•Automatic generation of skeleton files to support atomic operators. This capa- 
bility has become a necessity with the inclusion of unique suffixes to operators. 
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•Direct access to an editor to view/edit an atomic operator implementation. 

•Access to the reuse library from the PSDL Edit based on an operator’s speci- 
fication. 

•A PSDL Editor mode for performing maintenance on the reuse library. 

•The ability to save a prototype as a new revision within the Evolution Control 
System. 

•The ability to merge prototypes. 

•The ability to examine the prototype schedule from the editor. Computer 
assistance should be provided on how to modify the prototype in order to 
change the schedule. 

Finally, with the advances made in internet and intranet technologies comes 
the opportunity to improve upon existing applications. The migration of the PSDL 
Editor’s help facilities to a hyper-text mark-up language (HTML) based system should 
be straight forward. Such a system would be a great improvement over the existing 
capability. The conversion of the PSDL Editor over to a internet/intranet applica- 
tion would be much more involved. However, the resulting facility would provide a 
portable editor capable of supporting distributed prototype development. 
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APPENDIX A. PSDL GRAMMAR 



The following is the complete specification of the Prototype System Descrip- 
tion Language (PSDL) syntax in an extension of Backus-Naur Form (BNF) [Ref. 

14 ]. 

The BNF description of PSDL specifies the sequence of symbols which con- 
stitute a valid PSDL prototype. BNF describes the language in terms of production 
rules. Each production rule equates a non-terminal symbol to a sequence of termi- 
nal and non-terminal symbols. Terminal symbols are symbols which can occur in 
PSDL. Non-terminal symbols are metalinguistic variables whose value is a sequence 
of symbols which represents a PSDL construct. 

Terminals are represented as bold symbols (e.g., operator). Non-terminals 
are enclosed in angle brackets, ( and ) (e.g., (psdl)). Additional metasymbols are 
introduced in the extension of BNF to reduce the number of productions and non- 
terminals. These metasymbols are defined as; 

•Square brackets, [ ], enclose optional items. 

•Curly braces, { }, enclose items which may appear zero or more times. 
•Vertical bars, |, represent a choice between items. 

•Parentheses, ( ), represent a grouping of items. 

In some cases, the metasymbols used are also used as terminals within PSDL. In 
order to avoid confusion, such terminal symbols are enclosed within single quotes, 
(e.g.. ’)’)■ 

For ease of reference, each production rule is numbered on the left hand side. 
These numbers are not part of the PSDL syntax. 
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1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 



(psdl) 

::= { {component) } 

{component) 

::= {data.type) 

I {operator) 

{dataJype) 

::= type (id) {typespec) {typeJmpl) 

{typespec) 

:;= specification [ generic {type.decl) ] [ {type.decl) ] 

{ operator {op.name) {operator spec) } 

[ {functionality) ] end 

{operator) 

::= operator {op. name) {operator spec) {operator .impl) 
{operator spec) 

;:= specification { {interface) } [ {functionality) ] end 
{interface) 

;:= {attribute) [ {reqmts.tr ace) ] 

{attribute) 

generic {type.decl) 

I input {typejdecl) 

I output {typejdecl) 

I states {typejdecl) initially {initial.expression.list) 

I exceptions {idJist) 

I maximum execution time {time) 

{typejdecl) 

;;= {idJist) : {type.name) { , {idJist) : {type.name) } 

{typejname) 

:;= (id) 

I {id} ’[’ {typeJed} ’]’ 

{idJist) 

::= {id) { , {id) } 
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12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 



{reqmts -trace) 

::= required by {id-list) 

(functionality) 

:;= [ (keywords) ] [ (informaLdesc) ] [ (formal jdesc) ] 

(keywords) 

:;= keywords (idJist) 

(informal-desc) 

;:= description (text) ’}’ 

(formal-desc) 

;:= axioms ’{’ (text) ’}’ 

(type-impl) 

;;= implementation (id) (id) end 
I implementation (type-name) 

{ operator (op-name) (operator Jmpl) } end 

(operator -impl) 

::= implementation (id) (id) end 
I implementation (psdlJmpl) end 

(psdl-impl) 

::= (data-flow -diagram) [ (streams) ] [ (timers) ] 

[ (control-constraints) ] [ (informal-desc) ] 

(data-f low -diagram) 

::= graph { (vertex) } { (edge) } 



(vertex) 

::= vertex (op -id) [ : (time) ] { (property) } 



(edge) 

:;= edge (id) [ : (time) ] (op-id) — > (op-id) { (property) } 
(property) 

::= property (id) = (expression) 



(op-id) 

::= [(id) . ] (op-name) [ ’(’ [ (id-list) ] ’[’ [ (id-list) ] ’)’ ] 
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25 (streams) 

;:= data stream (type.decl) 

26 (timers) 

::= timer (idJist) 

27 (control. constraints) 

:;= control constraints (constraint) { (constraint) } 

28 (constraint) 

;:= operator (opJd) 

[ triggered [ (trigger) ] [ if (expression) ] [ (reqmts.tr ace) ] ] 
[ period (time) [ (reqmtsJrace) ] ] 

[ finish within (time) [ (reqmtsJrace) ] ] 

[ minimum cadling period (time) [ (reqmtsJrace) ] ] 

[ mcLximum response time (time) [ (reqmts.tr ace) ] ] 

{ (constraint. options) } 

29 (constraint. options) 

::= output (idJist) if (expression) [ (reqmtsJrace) ] 

I exception (id) [ if (expression) ] [ (reqmtsJrace) ] 

I (timer. op) (id) [ if (expression) ] [ (reqmts.tr ace) ] 

30 (trigger) 

;;= by cdl (idJist) 

I by some (idJist) 

31 (timer. op) 

::= reset timer 
I start timer 
I stop timer 

32 (initial. expressionJist) 

;:= (initial. expression) { , (initial. expression) } 

33 (initial. expression) 

;;= true 
I false 

I (integer. literal) 

I (real. literal) 

I (string. literal) 
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I (id) 

I {type .name) . {op. name) [ ’(’ {initial. expressionJist) ’)’ ] 
I ’(’ {initial. expression) ’)’ 

I {initial. expression) {binary.op) {initial. expression) 

I {unary.op) {initial. expression) 

34 {binaryjop) 

:;= and | or | xor 

I < I > I = I >= |<= 1 /= 

I + I — I & I * I / I mod I rem | ♦* 

35 {unaryjop) 

::= not | abs | — | + 

36 {time) 

{integer literal) {unit) 

37 {unit) 

;:= microsec 
I ms 
I sec 
I min 
I hours 

38 {expressionJist) 

::= {expression) { , {expression) } 

39 {expression) 

::= true 
I false 

I {integer literal) 

I {time) 

I {real literal) 

I {string literal) 

I (id) 

I {type. name) . {op.name) [ ’(’ {expression-list) ’)’ ] 

I ’(’ {expression) ’)’ 

I {expression) {binary.op) {expression) 

\ {unaryjop) {expression) 

40 {opjname) 

::= {id) 
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41 {id) 

::= (letter) { (alphajnumeric) } 

42 (realJiteral) 

::= (integer literal) . (integer literal) 

43 (integer literal) 

::= (digit) { (digit) } 

44 (string literal) 

;:= " { (char) } " 

45 (char) 

::= any printable character except ’}’ 

46 (digit) 

;:= 0 I 1 I 2 I 3 I 4 I 5 I 6 I 7 I 8 I 9 



47 (letter) 

::= a|b|c|d|e|f|g|h|i|j|k|l|m 
I n|o|p|q|r|s|t|u|v|w|x|y|z 
I A1B|C|D|E|F|G|H|I|J|K|L|M 
I N|0|P|Q|R|S|T|U|V|W|X|Y|Z 

48 (alpha. numeric) 

:;= (letter) 

I (digit) 

I ’ ’ 



49 (text) 

{ (char) } 
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APPENDIX B. PROTOTYPE EXAMPLE 



Early in the development of the PSDL Editor, a small prototype created by 
Dr. Shing was used for testing purposes. This prototype consisted of a few operators, 
and hence did not present a sufficient test case for the PSDL Editor. The lack of size 
of Dr. Shing’s prototype lead to the creation of an avionics.exaraple prototype. 

The goal of the avionics.example prototype was to use as many features of 
PSDL as possible and provide a medium to large size prototype to test the PSDL 
Editor. Since the PSDL Editor has limited facilities for types and generics, examples 
of these features were limited or non-existent. In addition, no attempt was made to 
test all combinations of expression evaluations. 

In addition, no attempt was made to provide a full avionics suite. The example 
presented is not intended to reflect an actual avionics suite, although aspects of the 
prototype can be found in aircraft that are currently in the United States Air Force 
inventory. 

1. ARCHITECTURE 

Figure 55 represents the avionic suite that is modeled in the prototype. The 
avionic suite consists of a six subsystems: Fire Control System (FCS), Radar Sub- 
System (RSS), Navigation SubSystem (NSS), Weapon Subsystem (WSS), Display 
Subsystem (DSS), and the Mass-Storage Subsystem (MSS). The FCS contains two 
dual-redundant processors, FCS-1 and FCS_2. The RSS contains both a radar an- 
tenna and an inertial platform on the antenna, which can be used as a backup navi- 
gation source. Two bomb racks are provided in the WSS. 

The avionic suite contains two data buses. One is used for the RSS and NSS. 
The other is used for the WSS, DSS and MSS. A single bus controller is used to 
coordinate all messages traveling over the buses. The FCS performs all bus controller 
activities. Since the FCS is dual- redundant, one FCS processor is designated as the 
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Figure 55. avionics_example Architecture 
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Figure 56. Minor Cycle Task Scheduling 



bus controller while the other monitors the health of the bus controller. If the bus 
controller should fail, the second FCS processor takes over bus controller activities. 

All tasks performed by the avionic suite are scheduled to be accomplished at 
different rates. The execution of each processor is divided into minor cycles and major 
cycles. For a typical avionic suite, the processors are executed at 50Hz. Thus, each 
minor cycle lasts for 20 milliseconds. A major cycle would consist of 64 minor cycles. 
All tasks are expected to be accomplished in a major cycle. During a minor cycle, 
tasks from two rate groups are performed. This is depicted in Figure 56 where each 
column represents a minor cycle. During each minor cycle, tasks from the 50Hz rate 
group and a slower rate group are performed. 

2. MAPPING TO PSDL 

Just as the design of an avionic suite would start with a high level diagram and 
decompose each component of the design, the prototype consists of a root operator, 
avionics_example, which is composed of a PSDL operator for each subsystem. In 
the case of the NSS, a simple pass-thru model will be used. No additional decompo- 
sition is required for a simple operator. Thus, the NSS is implemented in Ada. The 
other subsystems are more complex, and thus, are decomposed into a PSDL graph 
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implementation. 

Although no software base is provided for this prototype to facilitate the execu- 
tion of the prototype, two additional prototype components are required to complete 
the model. An environment-simulation operator is required to simulate the aircraft 
motion as well as the target environment and an air_vehicle_interf ace operator 
is required to facilitate the displays produced by the display _sub_system as well as 
providing a user interface for switch actions. Both of these operators are external to 
the avionic suite and are thus represented as terminators (square boxes) so that the 
execution time is not counted against the avionic suite. 

For the purposes of this prototype, the timing model previously discussed is 
too complex. Instead, tasks will be accomplished at either 50Hz, 25Hz or IHz. Each 
subsystem that performs tasks at different rates contains a mode control operator 
which schedules the tasks. 

In the actual avionic suite, each processor executes in parallel. Tasks within a 
processor are performed serially. While PSDL does not preclude the parallel execution 
of operators, CAPS Release 1 was implemented on a single processor. This prototype 
is also designed to be executed on a single processor. In order to maintain the desired 
execution rate of 50Hz, each subsystem is assigned an execution time which is a 
fraction of a minor cycle (reference Figure 57). Since the processing of each subsystem 
is simulated, the calculations performed can be greatly simplified in order meet the 
timing requirements. 

3. PROTOTYPE 

The decomposition of each PSDL operator for the avionics.example proto- 
type is provided in Figures 58 through 64. 
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Figure 57. Serializing Multiple Processors 



4. CAPS RELEASE 1 COMPATIBILITY 

Although this implementation of the PSDL Editor incorporated changes to 
the CAPS Release 1 grammar, an attempt was made to schedule the prototype using 
CAPS Release 1^^. Before the prototype can be scheduled, a successful transla- 
tion must be accomplished. It was found that the translator would not accept the 
property construct added to the PSDL grammar. Nor did the translator accept 
an implementation language other than Ada^®. The inclusion of operator and vertex 
identification numbers to the {opjname) also caused compatibility problems. Since 
the {opjname) provided in an {operator) {component) does not include the vertex 
identification number, where the {opJdys used in the {data -flow. diagram) does, 



^^Note that there is no implied compatibility of this implementation of the PSDL Editor with 
CAPS Release 1. This experiment was intended to identify compatibility issues. 

^®The CAPS Release 1 PSDL Editor did not accept a mixed case Ada. An all upper case ADA 
was accepted. Additional problems encountered with the CAPS Release 1 PSDL Editor include the 
finish within construct and Missing_Inf o containing two underscores in succession 
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Figure 58. avionics.exajnple Root Operator 
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Figure 59. avionics_example RSS Operator 
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Figure 60. avionics.example DSS Operator 
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Figure 61 . avionics_example MSS Operator 
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Figure 62 . avionics.example WSS Operator 
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Figure 63. avionics_example FCS Operator 
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Figure 64. avionics.example Environment Operator 
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each of these (operator) (componentys are reported as multiple root operators. 

After using a text editor to correct these problems, no additional errors were 
reported by the translator. However, this does not imply that there are no other 
compatibility issues. Only that no other errors were detected. At this point, the 
prototype was scheduled. Only one additional error was detected by the scheduler. 
The scheduler raised a TIME_INF0_ERR0R exception for having a zero MET and a non- 
zero PERIOD. 

No additional testing was performed beyond obtaining a valid schedule. How- 
ever, additional compatibility issues probably still exist but not reported. The lack 
of operator and stream identification numbers within (control. constrains) will most 
likely cause additional problems. 

5. LESSONS LEARNED 

The early use of the avionics.example prototype in the development of the 
PSDL Editor was extremely beneficial. Problems were detected with the PSDL Editor 
that required major rework of the system while there was still time in the schedule 
to accommodate changes. Specifically, it was found that the PSDL Editor required 
a large amount of time to perform syntax checks and took an enormous amount of 
system memory. In addition, the protocol used to exchange information between the 
background checker and the graph editor failed for large prototypes. Neither of these 
problems were readily apparent from the use of smaller test cases. 

In stepping from a small prototype to a large prototype, it was apparent that 
the PSDL Editor required too much time to traverse the prototype. It was typical to 
take 45 seconds to move from one level of the prototype to another. Timing analysis 
indicated that the largest component of this delay was due to updating the attribute 
tree maintained by the background checker, which uses Synthesizer Generator routines 
to maintain the attribute tree as in CAPS Release 1. However, each of these routines 
also updated the syntax-directed editor window, which resulted in even longer delays. 
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The syntaoc-directed editor window is not used in this version of the PSDL Editor, and 
thus resulted in wasted processor time. System performance was improved through 
the redesign of the background checker. A new Ada/C background checker, which 
did not use the Synthesizer Generator code, is now used to maintain the prototype 
data structure. This redesign resulted in greatly improved performance during the 
traversal of the prototype and significant improvements in the delays encountered 
during syntax checks and save operations. 

In the process of working with the avionics.example, it was found that the 
syntax-directed editor reported being out of memory (virtual memory swap space). 
The problem appeared to be one of accumulation. The syntax-directed editor started 
with a reasonably sized workspace. However, as the user traversed the prototype, 
the memory requirements grew until the available swap space was no longer able to 
accommodate the program. This problem is now solved with the new background 
checker. 

Between the background checker process and the graph editor process, two 
pipes are used to provide bidirectional communication. The protocol used to com- 
municate worked fine for small prototypes. However, when the avionics.example 
prototype was used, this protocol fell apart. The error resulted from the maximum 
limit on the size of read and write operations on the pipe. Using the larger prototype, 
this limit was exceeded. A solution was obtained by transmitting the buffer used for 
inter-process communication using multiple packets of a maximum size reflective of 
the pipe limitations. 

Besides these errors, modifications to the user interface were identified to im- 
prove user interaction. Once again, these modifications were identified after repeated 
use of the editor. They were not readily apparent from the entry of one or two 
operators. 
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6. AVIONICS EXAMPLE PSDL CODE 

The following is the PSDL code generated by the PSDL Editor for the proto- 
type avionics-excunple. 
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APPENDIX C. PSDL UNIQUE SUFFIX 
NAMING CONVENTION MEMO 



From berzins@cs.nps.navy.mil Thu Jul 25 15:40:50 1996 
Return-Path: <berzins@cs.nps .navy.mil> 

Received: from suns6.cs.nps.navy.mil by cs.nps.navy.mil (4. l/SMI-4. 1) 

id AA 10627; Thu, 25 Jul 96 15:40:50 PDT 

From: berzins@cs.nps.navy.mil (valdis Berzins) 

Received: by suns6.cs.nps.navy.mil (4.1) id AA08716; Thu, 

25 Jul 96 15:40:43 PDT 

Date: Thu, 25 Jul 96 15:40:43 PDT 

Message-Id : <9607252240 . AA08716@suns6 . cs . nps . navy . mil> 

To: berzins@cs.nps.navy.mil, irwin@cs.nps.navy.mil, 
kbmoelle@cs .nps.navy.mil, 

luqi@cs.nps.navy.mil, mant 2 ds@cs.nps.navy.mil, 
senrique@cs.nps.navy.mil 

Subject: explamation of the new unique suffix conventions 
Status : RO 

Unique integer suffixes in CAPS Release 2 

Valdis Berzins, 7/25/96 

To properly implement PSDL scope rules, 
which say that the names of the children of a 
composite bubble axe local to that bubble, 
we need unique internal names for PSDL operators. 

To allow multiple instances of the same type operation, 
we also need unique internal names for graph nodes. 

The implementation in CAPS Release 2 will be based on the 
following conventions: 

1. The psdl editor will supply unique internal integer suffixes 
for the names of stand-alone PSDL operators. 

These suffixes WILL NOT BE VISIBLE TO THE USER OF THE EDITOR, 
and will be supplied automatically in generated skeleton code 
for operators with IMPLEMENTATION ADA. 

The purpose of these suffixes is to allow two different 
composite bubbles to have children of the same name without 
conflicts between the Ada module names. 
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2. Names of PSDL data types will not have automatically 
created integer suffixes, because they are not needed. 

3. Names of operations of PSDL data types will not have 
automatically created integer suffixes. 

This implies the translator does not have to resolve 
overloaded operators. 

4. The psdl editor will add a unique integer suffix to 

each operation name to get the name of the corresponding graph node. 
This enables multiple instcinces of cin operation of a data type 
to consistently co-exist in the same graph. 

5. In release 2 the integer suffixes will be unique throughout the 
entire prototype and will be obtained from a procedure local to the 
editors (because there will be no DDE in release 2) . 

In future releases the suffixes will be unique across all 
prototypes developed at a given installation, and will be obtained 
from a unique id server in the DDE. 

Some consequences of these conventions: 

A. The name of the ada operation can be recovered from 
the name of the graph node by removing a trailing numeric 
suffix of the form digit+) . 

Note that the name of the graph node does not include 
the optional parameter binding part. 

E. For prototypes created under caps release 2, 

graph nodes corresponding to stcind-alone operators will have 

two integer suffixes, but only the second one need be recognized 

by computations in treinslation. The schedulers are only concerned 

with graph node ids, and hence are not affected by this convention. 

C. Graph nodes corresponding to operations of a PSDL data type 
have a single suffix. This suffix enables multiple instances of a 
type operation to appear in a graph without deUiger of confusion. 

D. Attributes and control constraints are located by visual 
navigation through the graphic editor, to avoid confusing the 
correspondence between graph nodes cind control constraints. 
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E. PSDL files created under release 1 may not have these suffixes. 

The concrete parsing rules of the sde should recognize such cases, 
and should add the needed suffixes if they are missing, 
to enable the sde to read old psdl files (CAPS release 1 format) . 

EXAMPLE 

Displayed form of the psdl, with explanatory comments: 

OPERATOR 0 — internal name o_13, graph node o_13_20 

SPECIFICATION 

INPUT a: booleein 
OUTPUT b: integer 
END 

IMPLEMENTATION ADA END 
TYPE t — internal name t 

OPERATOR 0 — overloaded, internal name o, graph node t.o_21(b|) 

SPECIFICATION 

INPUT x: integer 
END 

OPERATOR 0 — overloaded, internal name o, graph node t.o_22(|a) 

SPECIFICATION 

OUTPUT y: boolean 
END 
END 

IMPLEMENTATION ADA END 

OPERATOR top 
SPECIFICATION 
END 

IMPLEMENTATION 

GRAPH — internal form of the graph, whose display is suppressed 
VERTEX o_13_20 
VERTEX t.o_21(b|) 

VERTEX t.o_22(|a) 

EDGE a t.o_22(|a) -> o_13_20 
EDGE b o_13_20 -> t.o_21(b|) 

END 
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Displayed form of the graph: 



I I a I I b I I 

I t.o(la) I > I 0 I > I t.o(bl) I 
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APPENDIX D. GRAPH EDITOR PROGRAM 

SOURCE CODE 



The following is the complete source code listing of the graph editor portion 
of the PSDL Editor. The original graph editor source code was developed by Captain 
Robert Dixon, USMC [Ref. 13]. Additional work was performed by Mr. Douglas 
Lange and Mr. Dagohoy Anunciado as part of the NFS CS4520 (AY96Q4) class 
project. In several of the graph editor files, the authors of the graph editor have 
adapted code written by others. Such instances are credited within the source files. 

For a starting point, ge.driver.C contains the mainO routine for the graph 
editor. This routine is called by the syntax-directed editor to start the graph ed- 
itor. After initialization and establishing communications with the syntax-directed 
editor, the routine edit.graphO is called, which can be found at the end of the file 
graph-editor. C. 



action-area. C, 186 
action-area. h, 185 

build-option.c, 188-189 
build-option.h, 187 

error. hip, 402 
exceptions .hip, 403 
exceptions-list .hip, 404 

f ont-table .C, 191-192 
f ont-table .h, 190 

ge-defs.h, 193 
ge-driver.C, 194 
ge-interface .h, 195-198 
ge-interface_labels.h, 199 
ge-utilities . c, 202-217 
ge-utilities .h, 200-201 
ge_utilities_debug. c, 220-234 



ge-utilities-debug.h, 218-219 
get_unique_id.c, 236 
get-unique.id.h, 235 
gettopshell. c, 238 
gettopshell .h, 237 
graph-editor .C, 240-270 
graph-editor .h, 239 
graph-object .C, 273-274 
graph-object .h, 271-272 
graph-object-list .C, 277-285 
graph-object-list .h, 275-276 

id-list .hip, 405 
inforni-tool .hip, 406 
initial-state .hip, 407 
inter-procesS-Utilities . c, 288-300 
inter-process-utilities .h, 286-287 

Makefile, 183-184 
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windows. C, 397-401 
windows. h, 396 



op_prop_formal_desc .hip, 408 
op.prop-informal-desc.hlp, 409 
operator-object . C, 305-317 
operator-object .h, 301-304 
operator-property .hip, 410 
operator-propertyjnenu.C, 319-343 
operator -property_menu.h, 318 
operators. hip, 411 
output -guard, hip, 412 

postpopup.c, 345-346 
postpopup.h, 344 
print. hip, 413 
psdl-granunar . hip, 414-416 

report-errors .C, 348-350 
report-errors .h, 347 
resources. h, 351 

sde . c, 352-353 
sde-simulator . c, 355-357 
sde-simulator .h, 354 
setcursor.c, 359 
setcursor.h, 358 
spec-tool.hlp, 417 
spline-object .C, 362-370 
spline.object .h, 360-361 
Stream-Object . C, 374-382 
Stream-Object .h, 371-373 
stream-property. hip, 418 
stream_property-menu . C, 384-390 
stream-property_menu.h, 383 
streams. hip, 419 

timer-list .hip, 420 
timer-tool. C, 392-393 
timer-tool. h, 391 
timers .hip, 421 
timers-tool.hlp, 422 
trigger.if-cond.hlp, 423 
types-tool.hlp, 424 

warning. C, 395 
warning. h, 394 
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resources. h font .table. h 

sde: $(SDEOBJECTS) $(CC) $(C++FLAGS) -c graph.object . 

$(C) $(CFLAGS) -o ../sde $(SDEOBJECTS) $(LIBS) 
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"area" is ratximed unmeoiaged. (The user must meuiage it.) XtSetArg(args[0] , XmNsubHenuId, menu); 

Pulldovn menus are built from cascade buttons, so this function XtSetArg(args [1] , XmNlabelString, str) ; 

also builds pullright menus. The function also adds the right /♦ This really isn’t a cascade, but this is the widget heoidle 

callback for Pushfiutton or ToggleButton menu items. ♦ we’re going to return at the end of the function. 
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Font Table : : 'FontTable () < _f ont_table [C0URIERMED14] . _f ont.ptr 

int i; XLoadQueryFont (display _ptr , 



.font. table [0]. .height = in.string, strlen(in.string) ) ; 

_f ont.table [0] ._f ont.ptr->ascent + } 

.f ont.table [0] . .f ont_ptr->descent ; 

// Returns the height of the given font in pixels. 
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retxim XTextWidthC.f ont.tableCfont.id] ..font.ptr, 
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init_action(action) ; 
iiiit_graph_desc (current^graph) ; 
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typ«def struct spline.node 
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is aditad with mini-sda. ♦/ char* naxt_op; /♦ name of the next operator to be edited 



(X Xt 

o s 

rH til *0 
3 S5 ® 
<H H ■P 

wu* a 

d 111 e 



* tx * 

* t>> * 

* +> * 



i'S 

d iH 



* * 

* o * 

* ♦ 



* c * 

* *o * 

* c * 

: &: 

* * 

* * 

* ♦ * 



M O O d rH O ( 

• I I I I d I 

■P .P tX CU I 

p d d o o M 

0 9 9 I I •• O 

3 H H H H ^ ^ > 

M « C 3 3 M M ( 

p cu (X o u a • I 

M i 

p 

HH Q * Q ♦ * O I 

•5 ", a s a 2 1 

• a. ^ a. .d ^ p I 

“ “ O O U U «fj I 



to d 

9 9 

bo a 

d 9 

II 

C 

€> 

iH 

•S S 



til 

X ;z: o 

OOP 



111 H -H 

H X 
< 111 • 
Q > 3 

sa a 



I -H V) «H 



o P a II 
•H d 3 M X 

P Ih • « &i 

u e M a A 



I CO to CO 



i a 



a H 

o to 

U t-t 

[14 _) 



I-I * d d 
H * I o 
u * d H 
<c * o P 

* *H IX 

e * P o 

a : aci 

M * P ^ 
O * o H 
HH * 3 I 

* C X 

<H * P O 
• * W M 

•O * H 
e * «H O 
CU * e < 
K * XI I 
p * • bl 

* : 



198 



IH", 



r i‘ C .. .. s s - - -s' g a r ", I r i' .. 

.2 =",2,2 S.S'S'S ;• =•• %i r i=« .2.V2v §.i s. 

- § xV 2r r2T2,2 S-r I rs •Sfc'^.e: ssf 

■ • ■ ■ ^ " bo .« M 9 •* rt cu ♦> III 

1 = ll=-HIOI 



II II II II II II 



II II II II II II II II II It 



II II II II II II II II It II II II II II 



w -S « 

ei*3 5 i’-.t 




l||||||||||||||||l||||||||||||||||||||||| 



u o u u u u 



4>4d4>^4»4>4>^P4>4>4>4>4>^4»4»4»4>-P4»4>4>4d4d4J4>4>4»4»4»4»4>-P4»4»4»p.p.p.p 



« 

: 

* 

* 

« 

i 

* 

« 

« 

* 

« 

* 

« 

: 

« 

* 

: 

* 

: 

« 



: 

* 

« 

« 

t 

* 

i 

* 

: 

♦ 

* 

: 

* 



i 

3 

I 

9 

U 

9 

t2 

■S 

I 




: 

: 

* 

« 

« 

: 

« 



* 

: 

* 






II II II II II II II II II II II II « U II 




=. 15, -S it 

J. ii fllliil 

UrHUO II lllllll 

13 S S i a 2 5 2 a .2 .2 .2 .2 .2 .2 

I I I I I I I I I I I I I I I 

r— IrHrHrHr— If— ((HfHrHfHrHfHrHrHrH 

iiiiiiiiiiiiiii 

uouuuuuuuuuoouo 

•H "H -H ‘H -H -H -H -rt -H -H -H -H -H -H -H 

liniilllllllil 



199 



Name: ge.utilities .h 

Author: Lange 

Prograua; graph_editor #ifndef GE_UTILITIES_H 

Date Modified: 5 Oct 96 #define GE_UTIL1TIES_H 1 
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raturn(x) ; else { 

#ifdef GE.DEBUG 

.se printf ("ERROR: id_list_replace to a NULL location. \n' 

return(NULL) ; #endif 
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default : 

sprintf (buf f er » "'/,d illegal unit", time); 
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if (gdPtr != NULL) { 

#ifdef _NO_PROTO gdPtr->root_op_n€un6 = dup_str('"') ; 

void init_stream(StPtr) gdPtr->root_op_nuin = UNDEFINED_OPNUM 
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{ ' BOOLEAN valid_num_string(char ♦niun) { 

#els« #endif 

void init_action(ACTION act); 

#andif int index, num.length; 



(num[index] !=*-*) kft J 

((nufflCindex] < *0*) II (numCindex] > *9’))) 

return false; if (i == num_length) 

} validated = true; 

return true ; } 
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OpIdPtr = op ID; 

key = is_keyword(t6mpID, allow.types) ; tempOpIdPtr = tempOpId; 

froeCtompID) ; validated * true; /* assume it is validated until proved otherwise ♦/ 

process.next = true; 

return !key; *tempOpIdPtr = ’\0'; 
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case OPID.OUTPUTS: 

if (!((*0pIdPtr *= ’ ») II (♦OpIdPtr == *\t’))) { break; 

if (*0pIdPtr == ’)*) { 

state = OPID.CLOSE; case OPID.CLOSE: 

♦tempOpIdPtr = eOpIdPtr; if (!((*0pIdPtr == * *) II (*0pIdPtr == ’\t»))) { 
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if (!((*OpIdPtr s= » *) II (*OpIdPtr == *\t*))) { #ifdef .NO.PROTO 

if (validated = peu-se_id(OpIdPtr , fcidLen, false)) { BOOLEAN valid_type_neune(typeName) 

strncat(tempOpIdPtr, OpIdPtr, idLen) ; char *typeNcune; 

tempQpIdPtr += idLen; { 

OpIdPtr += (idLen - 1); /* will increment at the end ♦/ #else 
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BOOLEAN whit«_space(char *text) < templ->next = (AT_LIST) mallocCsizeof (AT.NODE)) ; 

#endif tempi = templ->next; 
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#ifnd«f GE_UTILITIES_DEBUG.H #else 

#define GE_UTILITIES_DEBUG_H 1 
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#ifdaf cplusplus 
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^include <stdlib.h> FILE ♦id.file; 

#include <stdio.h> unsigned int teinp.id, unique.id; 
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Written by Dem Heller. Copyright 1991, O'Reilly Associates. /* climb vidget tree until ve get to the top. Return the Shell */ 

This program is freely distributable without licensing fees «md extern Widget GetTopShelK) ; 

is provided without guarauitee or warramtee expressed or implied. 

This program is -not- in the public domain. #else 




237 



/♦ Written by Dzui Heller. Copyright 1991, O’Reilly Associates. GetTopShell(w) 

* This progreuQ is freely distributable without licensing fees and Widget w; 
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******«**«4>«*«*4>*«*****#**4r****4>4t*******4i****4>***********4<4>** Itoms roiDOved or tests added while testing (03. 
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static XrmOptionDescRoc options C3 = ■( . * sav®_stat6() — Updates the save.indicator with the current indicated 

{"-v", "viewer", XrmoptionNoArg, "True"}, * state. 
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breadc; // This function is called when a selection is made from 

// the list box displayed in the 'draw.options :Undelete Operator' 
default: // menu. 

return_sde_f lag = false; 

static void op_list_cb(Widget widget, XtPointer, 
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ls 6 1: = AskUs«r(app, drawing.a, abandon.script) ; 

font_list = if (reply == YES) ■( 

(XmStringTabla) XtHallocCMAXFONTS * sizaof (XmString ♦)); next_action_ptr“>option * ABANDON; 

for(i = 0; i < MAXFONTS; i++) next_action_ptr->r6invoka = true; 



f r«o(next_action_ptr->next_op) ; static void psdl_menu_cb(Widget , XtPointer client_data, XtPointer) •( 

next_action_ptr->noxt_op = graphic_list . current_op_naune () ; int itam.no = (int) client .data; 

next_action.ptr->next.op.num = graphic.list .current_op_num() ; 

return.sde.f lag = true; handle_psdl_options(item_no) ; 
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state (char*) client .data, fcstatb) ; save.opt = XmStringCreateSimple ("Save") ; 

ifstream from((chztr ♦)client.data) ; restore.opt = XmStringCreateSimple ("Restore from Save' 

len = statb.st.size ; print.opt = XmStringCreateSimple ("Print") ; 

buf = new char[len +1]; // Add a space for NULL exit.opt = XmStringCreateSimple ( "Exit") ; 
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// One® the user selects the Stream Tool and begins to draw, > 

// the draw_stream() function handles all events to speed up last_point_x = x_state; 
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first.draw = falsa; setcursor(drawing_a. True, XC.xterm) ; 

else } // object.def == STREAMOBJECT 

temp_operator_ptr->draw (DOTTED) j else { 

temp_operator_ptr->move(x - x.state, y - y_state); ibar.mode = false; 

temp_operator_ptr->draw (DOTTED) ; set cursor (dr awing.a. False, None); 
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else { select_state(TERMINATOR_TOOL) ; 
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dialog = XtVaCroatePopupShall ("dialog" , xmDialogShollWidgotClass , Widget text.w = (Widget) client _data; 

XtParent (parent ) , XmNtitle, "Timers Tool", XmAnyCallbackStruct ♦cbs = (XmAnyCallbackStruct ♦)call_data; 

XmNdeleteResponse, XmDESTROY, 
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rc = XtVaCr«ateWidget(“control_ 0 Lrea”, xnRowColumnWidgetClass , peoie, NULL); if (strcmp(text , org.text) != 0) { 

string = XmStringCreateSimple('*Viev or Edit Prototype Types Specification"); graphic_list .cur_op_spec(text) ; 

XtVaCreateManagedWidget ("label" , xmLabelGadgetClass , rc, save.state(SAVE_REQUIR£D) ; 

XmN labelstring, string, } 

NUTX); 



/-N ^ Uu 



0 « bO 

n 13 



fl • iH 

xi 9 in 
> xi 



cn • •• 



d «) .p fl ) _i 



w 

^ s> 



[ fH X 

I ’H 

; A II 



< » rt p 



p « p -V, 

X P X 



s 

2: 



a-s' 

P« o 



bO C CU 
flj TJ 3 
fl ^ o « 
3 c o 
s: c o. 
p M p 
X <H X 



a .o A 

o o 

•H bO P 
POP 
O »H d 

»H *0 T> 
iH 

^ W O 
U « 

«> *H p 
P O 
iH kl • 



O. O P P 
P d W 
X M M ^ 



•H ^ iH O 
:» X rj d 



bO H 



a 

p 43 « 



•dp /-V 

•HO o 

3 d 



T» iH 
O -H 
S «H 



•d iH 
M 'd 

> 5*9 



fc« 



-•^--> dd£ddd 

▼ Hf-ppxppp 



A nJ 
.J ..J 
D & 



a 

1 



fX 

n 

I 

CL 



-d rt 

•H p 

3 (0 
w *d 



a .2 



bO P H 

•d w 3 
Id -f? 



O W CL 
C O «H 
<Xi-l ® 

vt o A 



p CL 

0 ^ 9 '® 

•H o o ac 

P z = r 
«> S-> Vr* 



•H pS 

o H 
® tn 
CL W 



p ® 

O W r - « 



X ^ z « 

» a: 

II ® 

p ® p 
bO d iH • 

O ® P iH •• 

(0 3 P *d i-l 

•H CL a S J 




m > te 'd iH CL rt 
d fH iH O ^ Li Li 
-| fHfHS :®03 
MdOOPpH'd 
» fH Li Li -H -H X Li 

oooo'd'ddo 

LlPMM®®Ud 

xxxxxxxx 



odddddddd 

• ^ I— > L— I I— I l—J l_l l_> t—t t—t 

0 >-^MU nmoinnm 

n bObObObObObObObO 

g* a a a a a a a a 



P 4 » 4 »PPPPP 

• •«««««€ 

• bo 10 (O cn cn cn tn o) (O 

I LiPPPPPPPP 

ixxxxxxxxx 



265 



►J 



s 
■“ o 
= +> 



«M CL <H ^ f 



•o 'H 
S 0 
O xt 






M d o 



d d 

Vv' .H T3 -H 
M » :» 
9 a, X 



^ s ^ 



I <-S « M d 



Ki » rx 
d. M 
M : X 



^ ^ 



Hs n n M 



• d 

> <H 
O <H 



U i 



d 

• I 

p (X< 

n o 

•H y-N I 
rH J ♦» 

I -) d 

U S « 

3^ S 

Oi II 3 •« 
4 B — u ^ 

^ 2 
Mens 
Sen 
II 3 d d 
d rH I 

• I d a. 
I 0«> o 
3 o I 

d I V M 
I H CO 3 
d. 3 d o 
o o > 

I w «> « 

H X e 
3 'H M 



•g 



!3 » 



H w 

I « 

i? 

i-i d 
bu O 
U I 

ii 



' t> d 
I -H 3 



e 

I 

d 



H 3 dc'i 
3 I o •> 
o 43 I 2 
• p H a 
P -H 3 *H ' 
n » u p 



•H p r-l W £» S 

M I p p -H 

d u u d e P 

d *H O CO 

p e 43 d d • 

MB d C > 9 

w >H d p p M 

p M n X HH 



5 e. 



s> .. 

* o 



e TJ vp 

^ i c 



•H M d M - 

43 H o d e 

P *0 p P 0) 

> 9 



■S a 

p 
e 3 

■s 



P SH 
d d 



•O n TJ 

9 P 

d n 

o • • 

> > fi 

a 9 TJ 

. 9 

n M43 



p x( 

g 9 



P (O >0 p -H 



9 9 

> *d 



^ 9 



M 9 



T> 

9 

43 



bO u 
•d p 
•H d 



••-» n 
.d *H 
o TJ 



3 bn 



3 * 



40 d > H 

>H o d 
H d *0 43 
d n d u 

43 ^ 

u o rx 



I •• 

p • •• 

;; s is 

f ** 2 

O bn ►. d 
> u P P *H 
I P I 
deed 
H d d bo 
3 O o d 
p P M n 
• d d n 

M P 9 

M B B 
p • o 
d H p H 
•H X •< d 



u 

HH 

I 

•o 



n d 

2 s 

B u 

u 

bn P 
d n 



u M bO 



9 O 
> : 



'SC 



•S ^ 3 



d U 



5“^ 



b 

d *H 
H M 



II — 

d M 



O P M H 

p d e I I 

d • 

•H *d «H C 

^ B 3 a 

d o ^ 3 ' 



266 



^ J 

* u u ^ « o d 

^ I I u ^ I o 

u d d I u d 

^ I O O d 10 4^ 

udp-pod-pd 
I O «> <P 4> O 4> XI 

d +* d 3 +* d I 

d4>^rH 

4> d t I XI d Id 

^ X) B 4> I XI u B 

d I (0 u m I ki M 

X2B«f>VU«0 
I l-l M r-l d« « S HH 
d<CI<P •> >>d«'H d 

0<PnV>4>M4^-H 



-1' 
♦* rt 



•P Q ♦* 

0 o, o 

1 I «H 'd 
>» o 

d d * 

rH O ^4 

fX, C 4-> 




* cu a d 

d< I K O 

d d -H *> 

B O 0< P 

HP Id 
•H ^ d XI 

> i:i4 d o I 

d I XI p M 

o d I P M 

p o p d c 

4* u ,o B 



g - 



* iH I (I) IX. 
d p d 
o d B 
P XI 
P I o 
d O «H 

XI « d 
I P,H 
B n 



V) EU P 
d EU 



El< O 



U 4> d o -H 

> o P - 

O «• +> P 

M d p d 

N-/ o d XI 



o d «) M 



g i" " 

EU-rt H 
d EL. *H n u 

B I (X, O CO 

“ d IP 

o d P • 

a, 41 o d M 

I p 41 ^ P 

a d p I Ei< 

O XI d rH I 

4» I XI d >» 

^ - a ^ 

>4 I 



Eife.! 



^ c 



O d. 



XI o 4» X> 



li. 4> & d' -H 

O W 4* *H TJ 



UUUUUUUU 

dddddddd 

xixixixixixixixi 

I— li-HrHi— li-HrHrHf— I 
rHrHr— Ir— IrHiH r— liH 

dddddddd 

OOOOOOOO 

dOOCICICICCI 

4^4^4»4»4>PPP 
dddddddd 
>>>>>>>> 
•H -H -rt -rt -H -H -H *H 
4»4^4>PPPPP 
UUUUUUUU 
dddddddd 

111111=11 

xxxxxxxx 



d d • d p 

* o o d ‘OP 

d p p o d p d 

O 4» P P o P ^ 



p d I I ^ d I d o 

PXiBP ixina > 

d I d u w I »4 M o 

XIBddOUOO rH 

IPPrH^VB'H El. 

d.«)Pcit^Ei.>Hd o 

opmnpnp'H p 

Xtf x< x< x< Xtf X< X< n 

UUUUUUUU d 

dddddddd d 

XIXIXIXIXIXIXIXI r-i 

iHrHrHrHrHiHrHrH d 

•HiHiHrHrHiHr-lr-l > 

dddddddd p 

oooooooo ® 

TJtJ'd'dtJ’O'd'd VI 

^ ^ Tj *0 d 

pppppppp p 

XXXXXXXX X 



P O 
d d 
• > 



= iS 

“ 9 
« O 
* d TJ 
;» rH d 
I d Xg / 
d > n I 

■sill 

B X X i 




s ^ 



M M ^ M M M 

p p p p p 4^ 

•• El. El. EU El. El. El. 

I I I I I I 

M d d d d d d 



s .. 



!3 Id 



§ 



rH .4 • > 

I _) El « 

O p P «H 

>H ^ EU EU 

X3 I o 

CL, H • p .. 

d — rH r-s 
M p n M 

bO M -H Op 

P P d El. 

II El. rH I 



B u p d 
d d « d 
d M W 



P s-* bO bO ^ 

Si. Id Id ^ 



a I <E> > 

d 1-1 *d II •-» M w 

o M P X 



I 1—1 *d 
J)*-* o 

Id bO S> bO n 

^ n ^ o' 



d id 

a xg 

•H U -H U 



p Id 

d xa 



Id 

. xa . 



I M M M M M E4 

d u u u u u u 



E4 d d d d d 






u u 
u u 
to to 



-o El. 
d ^ « 

O tJ 



El El M M M ' 



rH Oi-lrH IOiH«H«H'H' 



O EL. W 
rH O « 

EE P El 



>» O 

EL, o 
n n 
•H o 

51 

X o 



U u 
P -H 
EE, rH 



rH P 
EE, O 
M O 



U O d ElOOOOOO dp. 
— > O UrHrHrHrHrHrHpQ d 



O O 

H K 

M. V -H >H 

o n > cu EE. 

p O XiS O 

O *0 O p 

drHdd.H- 
O .O -rl rH ^ rH 



EU EE. El. I 
O O 
O P P 
d -H tI • 



3 S S 2 s s s 



>>. 'N. V. Vv u o ! 



to El 
P O I 
X rH 



El O 
P N ‘ 
EE, -H 



O P 
El ‘rt 
U d 



ion II II II II II 



I *0 o 
I > bO 

I U O Hid 

• bOO 
: Hd o * 
P M 
‘ d n 
Xd o d 
n P a 

I d o I 
' B X o 
I bO 



tJ tJ 

§ I 

o o 
& w 

O XiS 

u o 

o d 

*41 X3 



•d *o tJ 

§ § 3 

o o o 
El El M 
bo bo bo 
O XiS o 
El U El 
o d o 

»H P «H 

I (N <N ro 
, > > > 

I u u u 

0 bO bO bO 



*d El o bO 



O o 
ti. I 

o o n 

M O u 
bO -H 
Xi! II .d 
U d. 

d x<i d 

P n El 
d bO 



CO a 



P 9 
“MO 
a O *0 
o p d 

•o d -H 
d o » 

•H O I 
9 I P 

I *0 o 

POO 
O P El 
O P 
El O 



267 



o >» 
O o 
lO -H 



» •* hO 

« Z O 

H H • 

•3 “ z ^ 

• Vi bq sz 

u ^ « a 

- gg*" 

X I-I o - 

u q, I ^ 

(« ^ U .P 

jD X W 

•H 'H 

iH • U > 

«J ® > <W 

O Pl.«C 

• K pg - 

W H ^ 

O PSP 
O, H X *0 



bO H bO 

s: *9 c - 

> •-« > 3 
« « « ^ 



X X 



d a. a 



bO 

s 



I p 
bO O < 

a o 



« « 

9 g 

« S 
1 " 
X « 



» ts 

« H 

•g § 



U. S; bu :x u 



• a a s s « 

X X X X X w 



^ > a p « 

p « a a 

«) d a c ^ 

• • ^ a u 

d a u ^ d 

rH ^ d UP' 
10 up dp' 



cn X ^ P 
d Cu bO«H 
> O >H C 



111 ' 



X X X X X K 




H “ H 

M P U 

o « o 
Q a o 

IH I IH 

:» 0.9 

I O I 

> a I a 

H O P O 

I X d X d X ( 

g-tlt: 2C 

IX d X H X 

p a « a d a 

d X ax u X 



d o 




iiiiiig 

X X X X X X a 




* 

'd -Tt 




iH • Q 
d *0 X 

•H « a 



9 9 



.9 5 . 

CO ^ « < 



p p 



k <N fO P • 



.PH * eg 

o. d » - P d H 

a eg O 43 43 H rH 
-oid'TJP hOhOc 
duMd'd'Htk^i 
I « d a *H « d d / 
d Ok « d , “ 



■H 



^ ^ ^ a X 
’ o ^ P “ 






Ok d d - P d H 
a CO O ^ 43 >H fH 
O 2 *d P bO bO c 

u w d tj ■ ■ ■ * 




268 



% 



o a, 

^ m 

>> u 



« « « 

• bo u 

: 

* *w ^ 



T> 0 



O - fl U 
M • H O 
O » SS 
“ « I 
h rH rH “ 
•P CU • »H 
0 « « > « 
I o: • > 

>> • iH ® 
(0 *0 0 « rH 



P • H 
P (N <0 
• CO ^ 



oS & ^ . 

1 >H .H ^ , 



<H U 

M bO 
bO F] 
a -H 

US 

s-^ 



F* • 

O rH • 
•H .O ^ 
P 4d 
« P TJ 

'm bO S 

§ H • 
<0 O 

B B 



<T> 



bO 



s _ 

•S 9 

M .nJ 



|25 



<0 F3 
P O 
bO rH 
<0 

P *0 

^ 9 



a, M 

Oi -H 

3 



O 3 
P T> 
O 

■o B 

« 

T 3 J 3 

D (1, 



a. M 
*e 

a: M 
w o 
w cn 
.c] X 

S'o;' 

M o 
boo: 

I a£ 

p W 



PF, M 
•H « 

M a. 



p • 
rH CU = 
CU-H S 



« ^ O * 



F4 P 



bO •* -H — 



« to 10 bO 

• 'S • 



pkl p 

I «o 



o< p 
• TJ 



SJ ‘rt >* -1 



« M O 
N H 

•H TJ - ■ 



bO P 

9 



bO P -H 



•H P P P 



•H Oi 
P iH 
O (H 



P T> O 
fl O -H 

O fl j3 

u *3 o« 

I bO 10 
® p 
bO 



„ -H W *H M 

'-r ll4 at Ut ® HH 

X P K M • 



§ “ U3 
5 o 
a S Q 

I O M 
Oibu » 
I 



a u 

I F3 



I » 03 
POO - O I 
F3 < «C rH < n 
® H H O H 3 
P H H O H P 

^ 1 *3 5 ^ « 

U M ! 



M X 



® 3 



bO 



® 5 B - o 

i - O ^ P 40 _ 

^ p ® U « p *o 

U ® P ® bO P *H 

® bo p P *o •< :x 

P TJ ^ P *H - 

P -H P X » 

<e ^ p p 

pu a* bo^ VI 
o o <H • ® 

P P M «H rH 

11111 = = 

X X X X X X 



M u] £ aq 

z z « S 

a a a a 

p o o o o 

rt < •< X X 

OHHHH 
•H H H H f- 

n 0 

•H X 



^ P M 




» 

•• 10 



•S’" 

•H » 



: ® 
; ^ 



I M p 
P ® P 
® P O 
M fl -d 



to 



® “ .d -H 

H ® bOrH 
10 rH *H I 
I .O ® U 
bO ® ^ -H 
F3 P M 
•H I - FX 

. 01 M ^ ® 

I M O (0 O P M 



I -H P O 
o ^ f 3 -d 
H FX o f3 

(0 U H 



■fe.' 



to *d ® ® Jj rH ' 



O *H 



-TV B 

I 

FX FX 



a a 



bO 



O hH 
•d X 

a 






w w X O 



269 



(*: o <o 
U) z o 

^ m 



bO 



I (*i 
U) U) 



II H 



* O ♦ 

* . « 

♦ M ♦ 

♦ o ♦ 

♦ * 

♦ *rl ♦ 

♦ *o * 



* J3 ♦ 

« PU * 

♦ 1^ * 



c c 



Q 

I *» 

u d 



PL, fH M PU 



O w +> 



O 



»H -H PU 

I iH 4 bO 

« I w (O 4 

T) O M U) rH 

n *H 4 >. «H 

I ,d 4 I 

d ^ II 4 

U a M — TJ 

9 k «> n 

■P ho -< >> I 



PL.-H »H 



■ H >, M P 



A A 3 rH 

I I M 4 

M »4 P «H 

P P 

PL. PL. II II 



d d *o 

0 0 4 

•H -rt e 

PPM 

POO 

4 4 «M 
I I M 
P P 4 
H H PLi 



d d 4 



S M M 
O P P P 
O PU 4 PL. 

I bO I 
P d TJ 
O O -H 4 



•t: !3 



• O N M 



I iH ’XJ 
J 4 w 

< 4 ,d 
D H n 
i ti 9 



4 4 4 ' 



4 ^ _} ^ 

M « p ^ » 

PL. 9 P 9 



p P n M 
4 4 19 
P P > P 



PL.>9 4 

PL. M 

9 ^ 



^i;5 



M 3 

PL. O 



• U 

M b] »H 

P E5 

4 t-i P 
I «H CS O 
» O 

: II 

II II 



I 



S 6 O P P 
M iH d « ^ 
! • O O O *H 

O «M rH ‘ 



P 4 4 M 

O P P 4 

B 4 4 0« rH iH • 



Sr* P > 4 



> > »M 'W 



4 d M 4 4 . - 

M >H PM 4 4 *9 



c s 



. . to 4 
4''^ feo 

M «H 

bO-H r 



Tl PL. PL. 
Md99- 
4 CO >9 *9 O 



■H *9 *9 *9 *9 
P Q B S Q 
•H o U O O 
d p p p p 
•H d d d d 

•H *H »H *H 

>». M M M M 
"v O, O, PL. O. 



£ » P P 

•*2 ^ S ® 
d •« a 4 
4 d M -H 
■H *H O rH 
rH 9 HH O 
O • • M 

P P A 
II d d I 



p I I I p 



4 > > > PM 



S P P P PM 

d d d o 

•H -H -H M 
V, M M M P 

Vk PM P, PM 4 



C 2 



• a 

I I 

> PM PM 



M U 



a 4 m 

SI 1 

p X X 
I 

w « • 

•H d d 

I o o 

PM P P 
OP P 
I 9 9 

^•^1 -^1 
O PM PM 
• O O 
p w w 



O 4 



J3 P 
PM 4 
4 CO 

w p 



9* 

P 

d 



s *9 

P 4 

d 9 



rS 4 4 4 



270 



=9 



I C • O 



o, o P S 3 9 -rt 



H .Q 

Ou (d 

J ** 

<0 I 
® M 

13 ^ . 

I O - i 
hO O M , 

0 a 

bO'O • 



.. . ^ - . 9 S 3 *rt ® ^ . 

•HU 0 U 9 <d 09 ^(l,'d<H 

>rlUU imut-l I'HC 

S 3 S 3 >> I T 3 



!3 

M 

V •- 



T 3 O O «5 4 > 



(d (« (d .p 9 sx, I 
r^ O O g I 

S3 k to • T) T3 B •< 



9 a 



rH S 3 
a, O 

W »M 



S3 o >d P u 9 



P p a u « 

P S 3 S 3 O H W 



X] ^ p 
p bO S 3 
T» 



’ IH 9 U 3 • 



PUP 
O U I 



« C I 
p p p 
I I S 3 
P P O 
S 3 S 3 •« 
O O * 
•M 'M 

P P <3 

S 3 S 3 X 

•H *H U 

U U U 




rH M S 3 r*, 9 



H ® O S 3 

P rH -H ’H 
P O.M 9 
« V) S 3 u I 
S 4 -H A 9 



P ^ p CO CO 

^3 see 

- SX, S 3 «« «c 



T 3 « Si • P 



•rl I w 
T> P M Vr' / 

O H P P '' 



V) «« rH O -H 



P iJUi ^ 

» ® Si] p 

I M O S 3 
S-> I *H 
I SO 
/-V CO « 

» V-/ «< p 

SI.rJ S 3 

A O -H 
a V-/ s-/ 
H >. • 
•H HH rH 
Sli *H *CJ 
I p a 
A O A 
• S 3 ^ 
H I I 

A « • 

I > > 

bO o o 

^ a B 



AAAAAAAAAA 

--pppppppp 



Si M Si Si Si Si 

•rt >H >H >H • ' 

> > > > 



pppppppp 

Si Si Si Si Si Si Si 



Si] SX. U 9 -H 
I •-] VI I I 9 'V 
I O ‘H m 9 A -H *H 

) O *0 U A Si O O 

m * H H *d > > 

jcs •a * 

I rH t>> SX, rH rH 

A A A 9 SXi A A 

SI rH Si O A ;3 S) 

SX, tO*C 3 “ 



S 3 H Si Si 



>>>>>>>>> 



S 3 P *M 
•H O O 
A S 3 



Pi 

A 

§ 

•H 

SXi 



• •HO 

jc3 a 

p p 



HH Si “ 
O 

VI P • 
VI -H P 
A *CJ A 



U p O HH 
C Si P 
•r-» • -H CN S 3 
.P ^ *d o> O 
O O • <H 

J 03 J Pi -P 
M M 9 a 
Pi P Pi CO u 
A SXi A -H 
Si A Si n «H 
bOU bOn H 



.. *o .. 
•• a O M 
Si A £ ^ 
•• O Si H 

• 43 bO • A 

a P o p a 

A ;3 Si A • 

«c SX o 03 



u • *0 P 
• >. Si 

•r-» A • -H 
JQ rH 4 i > 

o a, 

43 VI O • 
SX H P Si 
A •« A 

Si *0 
C^ VI • VI 



§ O 

^ 5 O 

A SX P 
A 

• Si VI 

13 

• • 

• Si TJ 

Si o a 

CPC 

e ” 



rH P ♦ 
C C * 

rH rH • * 

• 41 43 * 
O A P * 

ac p * 

I e * 
bO * 



CO VI 



• o 

9 S rH 

O rH 
S 3 



!3 : 



'N. o O * 43 



P * SX SX 



'N. N *0 
<0 -H A 

O) CO tx: 



43 S 3 = • 

• 'H 43 rH 

A 41 Si *41 

43 <H p n A 



•H V. Tl P 
•CJ rH iH I S 3 



P P P P P 

r—lr-lt—trHt—i 
O U U U U 

P S 3 P S 3 S 3 



I ® 9 

I P o 
. P T» 
O P 



VI VI 19 



O A 
rH P 

O I P P 
I U p p bo 
I P O P 
O Vt I 
bOHH I Si 
P IPO 
O * rH Si 
rH p Si 



Si®UUOUUUUU 
C5 P -H »H «H *H -H -H -H -H 
U4»4»4 »ppppp 

«®AAAAAAAA 

VIPPPPPPPPP 

AOvivinvivivinvi 



271 



virtual BOOLEAN hi t .handle (int , int) {return false;} virtual int text_width() {return 0;> 

virtual void color(COLOR) {> virtual int text_height() {return 0;> 



Q 

— I r 



U X 4> r-t 

e e M M ~ 



vt u. e 
1 (O P 
' fl O 
H < 

\ ;3 in M 
I p in I 
I • p 

• d rt 
*1 ^ 



•O *rt w 
e p e 
p o <-i 

« d T) 

■ ■ 9 

T> P ^ 



I M 
P «> 
« X 



'ds i 



I iJ *0 *o 
I O 'H >H 
>000 
- m > > 



3 3 ;3 ;3 

4i> p p p p 

P X X X X X X 
•H -H -H -H -H -rl >H 
>>>>>>> 



272 



I -P bO 
TJ -H 



O u o 

J3 9 9 
Ou •!-> 
n) ^ .a 
POO 
IS Xi Xt 
a, cu 
hO li a 
d p p 
o o o 



o •- 

xi ^ 



p • 

4» -p 

a. K 

I « “ 

>. p p 
id d X 
iH o « 
<p o -p 
n I d 
•H u o 
•duo 
* -H I 

^ xi • 

^ CU M 
id «s} (d 
rH P P 

a, bo • 



■H Xi 
a Id 
I p 



• » 
P o 
X TJ 
« d 
P -H 
d » 



u 9 (d o » 



13 ^ 

I O “ P 

bO u ^ 43 
d p bo 
H bO *d -H 

^ d ■ 



43 

•3 " d d 
* -d o o 



p u 
o o 
•d *d 

O -H 

o » 



13 ::i 



I Id I • d 



" 



II P P X II 



I n o u d 

o O I -H 



c dl 42 J 3 . 

d o P *d • 
I J I -H 
bOO P 9 . 
duo I 

•H X rH » 



P » » <« o o o 



01 Id Id p Id Id 1 

■H p p O p p 

'd bO © TJ *3 *3 



pppppp ©pp 

OOUUUO'^-r-tUU 

©©©©©©042©0 

•r-» •!-» •!-» *f-j T-j -r-i O ‘i^ 

424242424242 II 4).042 

000000 ao O 

43 43 43 43 43 43-h ©4343 

a a a a a a p a a 

-.-.-.-.-.-.^55-- 



p p p p p p o 



p p 



■H 000000 «H 00 



bO H 

d p »H 
•H o o 
Id d 
Q P 
01 VI 



O 02 

•d 00 
d 02 



«H P “ 
O TJ 
01 p © 
01 -H P 

rt rt 



bO 01 

O 02 

P 02 

a y-t 



© p p 

•I-, © .H <N 

42 42 *0 02 • 



a p a CO d 
© a © « 

p © p 0 

bO u bO ^ © 



U 9 



,d n o © 



: © -H 43 
I -o 01 p 
42 © © 



ac M 
• •OH P 
© 43 bO © « 

0 p o p a 

© d p © © 

s •© a C 2 03 



•H 02 

p 02 
O -rH 



© •>« 
02 

^ 02 



55 - is 



•d 

© 

p 

U 



© jp 

o © 

E P 



: S 



♦ w a 

* © © . 



S' 

& 



« U O i> 



•* © f— I 

p © 42 

X P © 
© © p 



•• p 

» a — 

O I P 
•d >» X 
d © « 

•H iH P 

a d ^ ^ 

I n o d I » <H 



P O -H o 



o © *d I u u 



I T> 



:: 



02 n 

CN o 



o 42 
© o 
•043 



i-i p p 



. -^ © "d 
• o •!-» I 
I © 42 •• 
1 - 1-2 0 •• 

I 42 43 p 
I o a o 
> 43 © « 



© © .. © 
P P p -•-2 
© bo u 42 
I I © o 

43 

•• •• 42 a 
p p o © 
u u 43 P 
© © ao 

’•-2 -<-1 © “ 



Sd © O iH p 

*d ao 
d n 

"Ss. -H .H u 

'V. :* 0 o 



.0 .0 p 
I o o o © 

; 43 43 ♦ rH 

4 a a 42 
© © a © 

p p © H 

o o g P 

u u -H o 
o o a a 



273 



return _f ont_table->height (f ont.id) ; 



O* r-l 

I 

>> «j 



274 



•d 

•H 

o 



s ^ 



« > S « O 



i I 

c: d 



^ ^ 

cu u u 



4. 13 

a M 



^ ^ ^ 



•r-i •«-» O 

^ ^ I 
O O 

4:3 ^ * 

cu cu u 



'S 

•H 

I 

M 



13 

43 



U] u 
Q cn 
i b] 

n o 



d o 

•> 

a V) 

•H 9 
-d iH 
• T» 

% 



w 

•d *d 



/-N r-l «M 
41 I 

+> o *d 

w 43 IH 
•H CU "H • 
^ <0 d 
•P b 41 
o o 



I'rH P S 



•H 9 b I I 



H tL. p4 h 
O W ^ -P 
tU Q 44 CU 
►->111 
CQ CO n 44 
O CO 0) U 
a «< A o 



: ^ 
9 Q 



9 C 



P 9 

5 O 

^ ♦ * 

44 44 

w 9 OP 

» M 9 9 

9 9 •>-% 

HP 43 43 

•0 9 00 

43 j3 

•O *d CU P, 



•H M U 9 



^ a. P 



bO *d 
d *H .- 
0 9^ 

at 

•d o bo 

9 *H "d 
4 d m <H 

: G> d » 

i *H 9 

: m a p 

d <H 9 

d a bo 



9 I -< p 
p p J o 
sp 9 o 9 

bO'*^ ••-» 
^ P *d 43 
9 -rt o 
9 p I 43 

I P Pi 
(A » M 9 
• H P 9 p 
0 3 0 

u. 9 cr 

1*3 •*-> 9 -d 
Q 43 P <d 

I O 9 

CO a o 

CO CUM *o 



43 43 *d 03 o 

0 0 9 *H 

I a 1 Pi P 
43 43 ® 9 

p< p PiCO u 

9 P, 9 *H 

P 9 p ^ <44 

bo O bO ^ -H 



a p o p s 

9 d p 9 9 

ss <c a. Q tc 



43 P P 
p d o 
999 
p p 

«H CJ P 

o o 

• p 
P M 9 
M P P 
•rt O 9 
»H 9 P 
•«-l O 

•d 43 
9 0 0 

■ai® 

•H 9 P 
fH p 9 
O X 



•r-i p O 9 

X a 9 •<-» 

O ‘H X 

X X o 



w X 

•H P 

■s . 



d o • 
9 p p 
a ^ d 
9 t>> 9 
.H P W 
P 9 9 

a W P 

•H W P 

9 

>> U lA 
iH 9 'H 
P d 
d ^ w 

9 b-» 9 
P P > 

as 3 

U 9 u 
d 

P O bO 
O -H d 
d p «H 
u d 
X d 9 
bo d P 
d <44 -0 
o 

X 9 9 
P X X 
iH P 44 



•d 



■d 

3 



9 •d 
O 9 

X -d 



9 •d 
o 9 
X -d 



o •d 
'V. 9 
o > 

»H O 

■V. S 
<0 9 
0> p3 



9 d 
•O -rt 
d «« 

»M 9 
•H *d 



d £ 9 -rl 9 ‘ 

•rt X »H P . 

p • p -H X 

p U 9 tH O 

d <H P >H I 



X bO bO bO bO <A 



o o u o o o 
d d d d d d 

•H -H -H -H -H -H 
<» 



. g 



>> lA bO d 






J 

d p 

9 "d 



X 

o 

X 

p 



o •• 

X "d b-» 
p 9 9 
9 P iH 
pop 

U 9 n 
P -H CJ 
(A O o Cd 

CA P 
9 P 



p d (A p < 

9 O d 9 b3 

a *d 9 bO X 

H d a -d o 

•H -H -H -H O 

p :x o rx m 



9 .. I 

g i n 



p 



<3 p l3 

X d X 



275 



void g«t_dal_op_list (char *del_op_str [] , 0 P_ID d«l_op_id[] , 

int ftnum_del_ops) ; ID.LIST tim«r_list() { raturn id_list_copy(_timar_list) ; 

void sat_undalated(CLASS_DEF class.typa, 0 P_ID id); 

void dalata_notify(CLASS_DEF class.typa, OP.ID dalatad_obj_id) ; char *global_typas() { raturn dup_str(_global_typas) ; } 
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char ♦cur_op_spec() { return dup_str(_cur_op_spoc) ; } 

int cur_op_spec_met () { return _cur_op_spec_met ; } #endif 

int cur_op_spec_met_unit (){ return _cur_op_spec_met_unit ; } 
int cur_op_is_terminator() { return _cur^op_is_terminator ; } 



Added streeuns to objects written out in write.to.sde . 
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gd“>tim«r_list = id_list_copy (_timer_list) ; GraphObject^ GraphObjectList ; :hit (int x, int y) { 

gd->avail_impl_lemgs = id_list_copy (_avail_impl_laiigs) ; GraphObject ♦temp_object_ptr ; 
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tomp.objact.ptr = temp_object_ptr->next() ; waming(_error.tgt , "Requested operator id not found"); 

return MULL; 
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// Sets the widget used to display the error message box. void GraphObjectList : :release () < 
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cheir '4‘neime; BOOLEAN GraphObjoctList : :has_dal6ted() { 



BOOLEAN GraphObjectList: :f«tch_matching_stream_type(StreamObject ♦toPtr , 
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#ifndaf inter_process_utilities_h BOOLEAN synch_read() ; 

^define inter_process_utilities_h 1 BOOLEAN synch_write() ; 
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BOOLEAN packGraphNamesO ; BOOLEAN readErrorHsgs(ERROR_HSGS *errs, XferBuffer *xfer, int Chi); 

void unpackGraphNamcsO ; BOOLEAN writ6ErrorHsgs(ERR0R_MSGS errs, XferBuffer *xfer, int Chi); 



#endif 
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/* Now read in the data */ 

#ifdef _NO_PROTO actual.size = read(Chl, packet.ptr, xf er_size) ; 

int read_xfer(Chl, xfer) if (actual.size != xfer.size) { 

int Chi; pr int f ("ERROR: read.xfer not able to receive buffer (packet */,d).\n' 

XferBuffer ♦xfer; packetidx) ; 
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#ifdef GE.DEBUG 
if (! packed) 

#ifdef _NO_PROTO printf ("Error in packID_LIST\n") 

BOOLEAN packBooleemCBool, xfer) #endif 
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while ((IDptr != NULL) ftft packed) { 

packed ft* packString(IDptr->id, xfer); 
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#else return writeChkWord(CHKWQRD, Chi); 

BOOLEAN readChkWordCint *chkWord, int Chi) { } 

#endif 
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else { /♦ recover any allocated space to next.action ♦/ 

if (SThead == NULL) ■{ free((char*) next_action->next_op) ; next_action->next_op 

STptr = (ST.LIST) malloc (sizeof (ST.LIST.NODE) ) ; 

SThead = STptr; /* f®tch data ♦/ 

} if (read_xfer(Chl, xfer)) { 
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#ifdef .NO.PROTO #endif 

BOOLEAN readAction(next_action, xfer, Chi) 

ACTION next. action; BOOLEAN packed; 

XferBuffer *xfer; 

int Chi; int.size; 
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96/10/06 K«n Moeller BOOLEAN in_is_composite , 

Removed code to read and write to property. BOOLEAN in_is_terminator) { 
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strncpy (temp.str , &(_nam«_ptr [wid«st_start_ind®x] ) , void OperatorObject ; :write_block(GC draw.contoxt , int x, int 

wid6st_string) ; char *instring, int block.height) { 

temp_str [wid«st_string] = *\0*; // kbm for g++ int i, str.lon, num.linas = 1, string.width, start.index = 

_neun«_width = f ont_text_width(_name_f ont , tomp.str); yinc, block_index = 0; 
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if (style == SOLID) _x + (3 ♦ .radius), _y + (2 * .radius)); 

XSetForegroundC. display .ptr, draw.context , .color.table [BLACK] ) ; .op.handles.drawn = false; 
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int OperatorObject : :text_height() ■{ 
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void OperatorObjoct : linitializoO i 
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#include <Xm/Xm.h> int x, int y, BOOLEAN parent.terminator , 

#includo "oporator.object.h" ID.LIST avail_impl_langs , 

GraphObjectList *graphic_list) ; 

#ifnd«f OPERATOR.PROPERTY.MENU.H 

#define OPERATOR_PROPERTY.MENU_H ttendif /♦ OPERATOR.PROPERTY.MENU.H */ 
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Prograuiun«r : K«n Moeller 

Langauge : C++ ^include <stdlib.h> 

#include <malloc.h> 

Description: This package is responsible for producing the pop-up #include <memory.h> 
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if ((♦char_ptr_adr 1= NULL) l^fc (**char_ptr_adr != *\0*)) id.list.dialog(w, client_data, ftkayword.display.cb, w); 

tmp = XmStringCreateSimpleC' Formal Desc... "); 
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//check to make sure entry is not null return; 

if (XmStringGetLtoR(cbs->value, XmSTRING.DEFAULT.CHARSET, } 



if ( !XmListGetSelectedPos(list_w, fepos.list, fepos_cnt)) i 

static void id_list_add_cb(Widg«t w, XtPointar cli«nt_data, wea:ning(w, "Nothing Selocted"); 
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return; int coimt = 0, i, n=0; 

> ID.LIST idp; 

Arg args[5]; 

XmListDelotePos(list_w, pos_list [0] ) ; XmString *str, string; 



str = (XmString *) XtHalloc (count ♦ sizeof (XmString)); action.a = CreateActionAreaCpane , action.items , XtNumber (action.items) ) ; 

for (i = 0; i < count; i++) •{ 

str[i] = XmStringCreateSimple(idp->id) ; XtHanageChild(p 2 uie) ; 

idp = idp->n®xt; XtPopupCdialog, XtGrabNone); 
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static void mrt_\init_cb (Widget w, XtPointer which, XtPointer cbs) { 
XmToggleButtonCallbackStruct <»state = 
(XmToggleButtonCallbackStruct ♦) cbs; 
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char *prompt, buffer [INPUT_LINE_SIZE] ; XtManageChild(met_unit) ; 

char ♦required_by_str = "Required By"; XtManageChild(met_req_by) ; 
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static void output.gueurd.cb (Widget w, XtPointer client.data, XtAddCallback(text_v , XmNmodifyVerif yCallback , validate_text , NULL); 

XtPointer call.data) { 

XtManageChild(rc) ; 



action.a = Creat 6 ActionAr 6 a(p 2 ai 6 , action.items , XtNumber (action.iteins) ) ; Widget dialog, pane, rc, text_^ 

XmString string; 

//XtAddCallback(text_w, XmNactivateCallback, activate_cb, action.a); cheo* ■(■description; 
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XtAddCallback(t«xt.w, XmNmodifyVerifyCallback, validate.text , NULL); 
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XtHanag«Child(t6xt_w) ; } 

//text.w = XtVaCraateHanagedWidget (*'text-fi«ld" , xmTaxtFieldWidgetClass , 

// rc, NULL); fraaCtaxt); text = NULL; 
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XtPopup(GetTopShell(op_dialog) , XtGrabNone) ; 



functions used to post popup menus. 
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} /* Close scope of 'extern "C”' declaration which encloses file. ♦/ 

#endif 
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void r6port_orrors(ERR0R_MSGS errors _pre s ont , Widget widget 
ACTION next_action_ptr , BOOLEAN ♦return.sde.f lag, 
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XtDestroyWidget(wd->peu:ent_w) ; 
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retxirn; str[i] * XmStringCraataSimple(errStrBuf ) ; 

fraa(arrStrBuf ) ; 
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writ«_error_string("camiot establish GE process"); printf ("Error opening graphics editor\n' 

return; } 



close (g«_to_sde_chaimel Co]) ; 
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/* Send data ♦/ 

writeGraphDesc(current_graph, xfer, ChlWrite) ; 
writeErrorMsgs(SDEerrs , xfer, ChlWrite); 
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p3 = p2->_next_ptr ; /♦ Debug code 

p4 = p3->_next_ptr ; if((pl->_x > 1000) |i (pl->_x < 0)) 
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float inc, t, t2, t3» terml, term2, term3, term4, x, y; XDrawPoint(parent->display_ptr() , 

_spline_node *pl, *p2, *p3, *p4, *temp_node_ptr ; ♦(parent->drawing_area_pixmap()) , 

BOOLEAN need.handles; graphics.context , i, j); 
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void SplineObj«ct : : s 6 t_nam 6 _locatioxi(int fenam«_x, int ftnaxno.y) { 
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<= y) 

temp_node_ptr = _head_ptr; (y <= ( (temp_nod«_ptr->_y) + (HANDLESIZE / 2) 

if (_head_ptr !* NULL) { HITFUDGE))) { 

for (i * 1; i < num.nodes / 2; i++) _hzoidl«_s«l«ct6d = nun.hzoidle ; 

t«mp_node_ptr * temp_nod6_ptr->_n6Xt_ptr; return TRUE; 
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void SplineObject : :build.from.sda(SPLINE.PTR sp) { 
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BOOLEAN spline_empty() {return . axe. empty () ;} chaur* state.initial.value () {return dup_str(_state_initial_value) ;} 
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Name; stream.object .C #define MAX.CONTROL.POINTS 100 
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Date Modified: 11 Sep 92 
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Removed build.f rom.property aoxd write_to_property . 



STREAM StroamObjcct; ; clone (OP_LIST op.list) { 



P. » P. tH (O 



S’® % 



<d iH *H iH 



K >t U U 



I ^ Id - 
Q N Id 
Z M N 
«C CP HH 
X Id CO 
^ Id 
I Q nJ 
I z o 
■» -< z 



p. bO CU /-s 



9 9 9 



u i I - * - 

in n w 

o d * o * o 

n I li p. P p. 
^ ' 
)h *> P< z P« Z 



H ja xi ^ 

bO 4 ^ Id 
-•HUN 

« c -H »H 

n H ^ » CO 

rH C I I Id 

n p c c j 

■" g 9 9 i 

II o d d < 



^ I M >> 



% % 



o o o o 
P. Pi P« P< 
I I I I 
Z Z I-) 
M >* M >» 



CO II -P 

•« d 

a: o 

Id H u 



o n - 10 - 






d 3 ' 






I u z *d z 



O U rH 
P, « u 

■g 9 
■S-“, 

c e 

”i 3 
2 *=* 
3 J 

d ^ 



o I + -»- II 

■H 

X V) n M d 

p. o o o 5 

<0 Pi Pi Pi (0 

h I I I H 

bO z z z u 

I >> H >0 I 






Id CO 
CO Id - 
•«C rJ Id 
X O N I 



I Id I 
_l I 
O I 



« H X .d 



S'®, 

d 



tB CO 
I Id — 
« id « 



9 91 



o d d <e <0 



g .s ' 

(0 X U 
H o 
U 10 P, 



W bO Z Z Z 



M V) d 

o o 5 
P. P. (0 



I H >« I 



U M 

s 

X u 

•' s 

S-^I 

^1 3 



d - 
o u 

O 



- 4 » 

•“ » M 

O I 
P u >. 
d d u 
o H d 

I 1 p 
» (0 .. 
' U <0 iH P 



/-s « 



p (0 O P P 



- -s 

Id p I - 

Z (0 n 



UP I >» 
Z M >> 

•H C (0 - 

U P iH W 

u d P« o 
Q o n p, 

Z P 'H I 

5 I u u 

I M 






tH U 
U N - 

O »H u 

CO CO N I 
U ( 
II U CO I 



« H • H /-» 



U CO 

d u 

« id 
P Q 
<0 Z 



>» * H bO 



g o iH iH 
I I I 



p H P P VH 



<0 .. 



I X 



Pi « 
■H I P 
I ►. d 



>% I U rH p I I in 



d rH U d d P 

« P. I « « U 

rH n » P rH C 

-H (0 <0 rH 



V U ^ rH P 



bO 



II 10 ' 



U p M 

d d p 
« O CO 
P HH » 
e 0 I <0 
rH P p 



I 



U &u' 

%J 

M U 

I « 

rH 

U 



d <0 I 

® rH » 
P I (0 



? * 
S 9 

X M 



- bO 
d d 

O *H 



U H 
C rH 
•H P« 



J3 U bO 

pod 

a -H 

u 

d rH 

d O M 
O I « 
H c U 

V 5 i 



s 



«0 d ^ 

5 P 

O (0 n 

U 



c bO 

®l 

H ^ 



N 

P CO P /-V 
H U K U 
« U O N 
P Q P M 

d z d CO 
o •< o u 

U X o u 
I 



I - 
9 U 
(0 N 






» u 

> O N 
U M 
I d CO 
•H U 

» u 

I Q 

» z 



' Id 

v :^:3 

• P CO 

cu u 
I u 
. >» o 

I <0 Z 



CO 

- u - u 

» U » N 
O Q O HH 
U Z U CO 

d •< d u 

•H X >H U 

9 9 a 

I - I z 

» rH » ^ 

(0 >v (0 X 

•S - 

I U I u 



Pi X Pi 
10 10 • 
a - a rH 

H U H 
•H N -H 
P M p - 

I CO I u 
<0 u <0 N 

- U « HH 
“ ■ CO 



Si S i 9 



N 



N 



^ - 
I U 
N 



^ ■ 



P CO 

J W 

(0 U 

si 

I X 
bO 
d I 
•H 

9 <N 

<0 ►, 

^ - 
I rH 
* H 



)h CO ^ CO )h CO 
P U P U P U 
P id P PI P PI 
I P IQ ■ “ 
^Z >»Z 
(0 «c 10 «« 
rH X rH ® rH X 



I U — P 
bOp M 
d Z U « 



.•sji 

* - X ’ 



IhP .. )hp*-)hp 



^ 4» HP Ml 






p « p « u 

I I P N 

d >> d HH 

.. <0 O <0 O CO 
U rH U rH U U i 



P M I 



P « U 
I P N 
>^dt-H 
CO< 0 O< 0 OCO< 0 OCO 

- -- rH o m 



M - - 

P « U M 
I P N P 
>» d M p 
10 O CO i 
rH O U 



rH n n I n I n I o 

d< <H • H H H X n 

WUrHUCHUCNUCN^U 

-H I bs I H I bs I H X I 



I a, I rJ P I U P I U <0 
:>n»Qn»on»QrH 
^ <0Z'H(0Z:H«0ZP 



u u H •< U JH • 

•3 I u X I u 1 



bO bO bO bO 

9 9 9 9 



9 9 



375 



M 5 r 

O rH 
« H « 



g » g 

• I u • 

„ _ ♦> bO O 

«os H +> H (3 rH H 



J W 

a H 

• u V ai H u) -H 



*H (0 



■S % 



■P <0 - 

(X, o s 
I O iH 
t»% iH (d 



Kl -P « 
•P H Id V 
(X, « O H 
I -P O b) 
>. fl iH = 
<d o I 
‘ rt fl 



O u • n 
O .H M 
I 73 H U) 



(X, I P 



- • iH 

« -P ^ 
P M ♦» 
73 ® W 






a -p 
O Vi 
<H a 



g 

» 

Id 



« bo 
M (3 
O -H 



13 



4^ « 

2 

d p 



s ^ 

> tJ 

bO 9 

o 

• jO 

P « 
Ji 
tH P 

d 

« -H 

d .d 
p p 
P *H 
» 

« 

d u 

3 ° 



I — 

• • 



j 3 



I 



§ % % 

d d rH , 



H >« M >> 



O O O O 



H (»% H >% 



§5. 



■H P . 
p Id 
P rH 



d, 01 n « 

I I O O iH < 

.J O. CU « I 

H I I 01 ; 

^ J J I ] 

tH I 

I II II o 

' A V M II d I 



1 >.1 
r a 



U • H H 



Id 



« p w > 



S 

Id 



XI Ji 
bO P 

- -rt *o •« 

U] « -rl /XV 

M XI » (*] 

• IH I IN 
P t/1 t>-» t>-» M 

H Ul O O CO 

« ^ d d b] r 



o «« Id Id a 

W m iH iH -< II 

I 11®^ 

0) I d 

o I + + 5 

' -H Id 

I X 0 ) 0 ) 01 0 ) P 

I rxs p. o O O 0*0 

1 /-j «J fu p, tXi CP I 

I b4 P I I I I 0) 

I Vi bO^ _l U ^ c 

I < I M >. M »H 

I OJ T3 






I I 



b« 

55 



b) 

Vi 



I <H b) 
I rH 



O • 

■H T7 

® X 
P.O 

g s 

bo C 



to 



se 



P p 

x> d H 



/-V /-s P 



I P Q 
5 IH 



II — to H 



iH O » 
« P P Id 
T3 0) ^ 



01 p « p p 
tJ 01 73 IM 



r-s d - 



O Oi 
O b) 
rH H 
I X 
d b) 

I 



• £ 




376 



x(x^pos) ; 

BOOLEAN StreamObject : :over(int x, int y) i y(y_pos); 
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} _latency_width = f ont_text_width(_latency_f ont , 

_lat«ncy_string.ptr) ; 

void Str«amObj«ct ; :set_d®fault_text_location() < _lat®ncy_height * f ont_text_h®ight(_latency_font) ; 



void StreeunObjoct : :set_obj«ct_font (int font.id) < .latoncy.solectod = false; 
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int StreamObjoct : : text_width() i else 
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_id = st->id; void StroamObject : : copy(StreaunObject *src) i 

_name_ptr = dup_str (st->lab6l) ; // kbm 

_name_font = st->lab6l_f ont ; _id = src->_id; 

_name_x = st->label_x_of f set ; _name_ptr = dup_str (src->.namo_ptr) ; 

.name.y = st->label_y_of f set ; _neune_font = src->_n2une_f ont ; 
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Programmer: Man-Tak Shing ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦**♦♦♦*♦♦♦*♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦/ 

Langauge : C++ 

^include <stdlib.h> 

Description: This package is responsible for producing the pop-up #include <stream.h> 



.a << j 

. bO 

a d 0 



A A A A 
M M M 



9 M • p 9 -H /\ js aa 

bO*Ur-lr-l-P«Ij3 *C 



.. (0 (0 ^ ,o n 

XHMOidHido 



>s.ciou.i-)i-)aE:x:cucuo:o)( 0 (nHi 



X X X X ; 



; X X X X X X X 



MM- 43 X u 



CM • )h -i-t o u 

U«rHOU43«e 



n»Mr-t(VKHbO 



9 O •*-**«-> = 
I 43 .O 



M'H43’043 M O O 
C iH m « O O I I 
■P *H CU I I P c a 

apo 4 a 43 itfd 3 

•H 3 p (X P H 9 
I I P Id <0 • r-t M 

---^ipoupup 



43 43 
bO M 

a » 

•H O 

a tj 

s.*? 



vvvvvvvvvvvvvvvvv 

99999999999999999 

XrHrHiHXfHrH*HXXXXrHXrHrHiH 

UUUUOUUUUUUUOUUUU 

ddddddddddddddddd 



Id bobobobobohoo n m » » 



ccc««cccccoc 

’d'O'O’O'O'dTj'dTj'dTjTJ 

pppppppppppp 

<— I t—i (— I I— I I— I I— I I— I I— I I— I I— I f— I f— I 

ooouuuouoouu 

dddddddddddd 

•H -H *H -H -H -H *H *H *H -H *H -H 



•H W -H bO X rH 
I I d o Id I 
P X -H r-l > B 



V) Id I Id 



•n « fl 



p -d -H 
Id I d 
P P -H 



(il bO bO bO P _) 

2 t 3 t 3 U Id o 

H -H -H -H 43 O 

03 DC 3 c 2 U 03 

u u u o u o 

•rt *H *H -H -H .H 

p p p 4> 

Id Id Id Id Id Id 

p p p p p 



cu ♦ 

9 

9 a 



M o *d 

•H 43 I 

•o IS- 



'd vt « 
d -H -d 
Id *H 
bO > 
bO o o 

d «H p 

•H Id cu 



P -H -H 
Id 43 rH 
43 » rH 



9 

6 



PL. 



g-a 

pL. m 



% .s 



•o Id 
43 -d M 
o a, o 






I 43 43 
C U U 
P I I 

Id c >> 

P ^ P 43 

n p>k c u 

I P d I 
X I d" 

- - I o o 

c d d 

P c p « ■ 



9^' 9' 



9 9 9 9 



MidppM^biki 
-pididpppp 
M «H >H M m M M 






384 






C' s 



O iH 
<B (B 
> -H 
’ TJ 



id I— • 

> o 

I 

C 

I -H bO 
fj *o 
■H >H 
I Ik 

« *o 

rH •■ * 

(0 • O O 
♦> -H in CO 

M bu ^ ^ 



O) c « 

* iH CU 
H a I 

■H > • 

Hh 2 a 

• ^ iH 
IH X <B 
CU > 

I • I 

• « P 

3 3 H 



4> ♦> — 

■H -H /«>. 

fi d K 
■H *H <H 
dM I *H 
« • 
-•PM 
P (B CU 
H P I 
• « « 
p >-/ 3 



I a p 

M >> <H 
p p d 
n c -H 
I in 

>» d ® 

(Xi > « 

O P M 

I O X *H 



d - 

■H J 
I _) 



111 



a, 

- •- -H 

bO bO M 



bO p M 
T3 in « 
H Q 43 
Ik X u 



II P i-l -H 

S ^ d 

c - g r 



d P bO 

d o 

P iH 



A 4^ M a 



u X 3 '• 

•H O o w 



A cn 

•H U] 

■3“^ 

d X 



II w . • 

PAP 

bo d X c 

o c P X •• 

rH M -H • /-s 

A 10 P '0 •_] 

5?!ll| 

X X X z 



3 

1 



r I 



I 

p 

d 



- J H 

^ P 43 

j 5 - a 

PM A 

P II O M 

M O 

II X M M M bO 



A a d I 

> I • • 

I • p i 

«> p 3 A A 

bO H iH iH d 

O d A I I 

•3 ■'*, =’■ S I 

•H • P • • 

•o -H M M 
I A d P P 

P P <H M n 

M n « 

Z z : 

P P X X < 

u] (d I 



fc? 



1.13 



M P 
P O 
n • 



bO bO M 
•0 •« A _ _ 

•H -H 43 o O 

P Ik u 03 A 



_) U a 



bO c H 

•0 P iH 



A § 



" g 

I II 

a 

B P 

• H 

P « 



^ 43 



i'3 



2 ” I 

P rj rt 



H > = S-» 

® d 

P l-H w M 
s 3 ® 



•0 « rH /-s . 

• H bO I J ' 
X d ® II -] 



a *0 C9 p p ® 

» 3 -H Z X M M 



A i Q 

VI d A 

- S M 
P A P 

H ® <n 



44 d ® ® 






•0 a 
a p 

3 X 



I I 



i§ 



p p 
M A 
I *0 



P A 

-H U 

d 



P 41 
® u 
bO « 



385 



: 9 

/-» o 

■S s 



s-> o • 

M 

/-V «» O 
.p U 

X C 

® >» - = 
P M ® • 

® i ^ 

I ® c 

as iH 
a a ® u 

® K *0 

tx, ® P I 

>» cu _ ® 



a ® M >— I 

> M ^ • 

— p iH 

« « -O 

Ai bO-H 

<u *d ® 

•rt «H ^ 
rH iH 

- rt »H *o 
O > = -H 
^ fl 

• tH n II 

: 3 •• 



5 I 

B B 

I I 

® ® 

6 & 



I M Q, 

• •• • ^ 

I S ^ P P 

I 3 .j I- 

I b) « 3 I 

: ® 0) X ® ; 

I pu I u- M 4 
u ^ O P P < 

I p K X n I 

IH 

= a: 



I /-V 

® p 

&s 

p p 

a ® fl 
3 ® 1 ^ 

9 u P 
X u« P 
p p ® 
M X 



PUMP 



•O ® P X 
•H p P P 

» rt ? w 

.H H ^ 



0 rH 

^ a 

rH O 



•H ® bO 






I P 

cx, ® 

e V3 



a - 

s 



M <H II O 



•H a rH •« (L. 

P P a -H 

•H n > :x 

d — I TJ ® 

•H ' p rH « - rH 

w H ® O O 

w iM d *H lo ro a 

•H -H tel rH rH P 

NH IP -H 

•H ® M * “ TJ 

P ® H >r « 

2*5111 

m H X X X 



® “9 

9 U 

Or d a. 

I rH I 

® a ® 

d > 3 

f~l ^ r-t 

as® 

> X > 

I I 
p - p 
•H ® -H 

d d d 

•rl rH "tH 

•“ $ 

“ I 
X P ♦* 
P -H 
M d H 
I ‘fH -rl 
rH I *H 

a ® « 

•H p ^ 

p a a 

•H p I 

d n ® 



r I OT ^ 

I X ® ® 

I a > « 

> o P 
: rS O X rS 



s =. 

a d 



§ s 




u » 

S J 

O M 






p 

® bO 

^ d 



bO 

•d o 

•H bO 



•o W »H 



p a bo 
a P d d 
« cn a >H 
X a 3 e: 
o X « P 



X bO Vi 41 •“ • 



X M X X 



rH J P 

""I 



« > as -d rH a 




I ® d 

I rH 3 



i u I a 

w p ® •- 



oddodddod 



• ® o J 
I p a !-> 

— 

Oi—juiinnnnmnnmvi’dpz 
u bObObObObObObObObOUrHX 

" J 

VrMMViViViViViVi bO 

4»pppppppp 
®«®«®®®®® 

p bocntncncocncotncoto hl^ . 
d ihppppppppp ®P'*<»'*r. 

•H««XXXXXXXXX PX>s.>s. 



6 “ 
® » 
bO I 
® p 

S S 



•d >-r 

s ^ 

p 

: d 

« H 
O O 

: a 



6 

9 

to 

a 

s 



a B 

9 9 

•H P 



^ S‘ 



XI ® 
.H P 

o d 



u a 

•H P 
P X 



bO H 

•d 3 

•H 43 



386 



text = XmTextFieldGetString(temp_w) ; 



XtVaSatValues(initial_state , XmNsensitive , False » NULL); 

if (state_init_value) { Widget temp_w = (Widget) client.data; 

XtUxmanageChild(state_init_value) ; 

state_init_value = NULL; if (stream_latency_error) 

} XtVaSetValues(temp_w, XmNvalue, NULL); 
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static void latency_error_cb(Widget w, XtPointer client.data, static void stream_cancel_cb(Widget w, XtPointer client. data, 

XtPointer call.data) { XtPointer call.data) { 
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XtSetArgCargsCac] » XmNheight, 300); ac++; // create a state.stream query label 

XtSetArg(args[ac] , XmNwidth, 310); ac++; prompt » dup.strC'Is a state stream?' 
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void timor_tool_add_cb (Widget w, XtPointer, XtPointer) ; 
void timer_tool_del_cb (Widget w, XtPointer, XtPointer); 
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XtPopup(XtParent (dialog) » XtGrabNone) ; 
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Name: weurning.C // XmString ok = XmStringCreateLocalizedC'OK") ; // Q1 

Author: Lange and Anunciado XmString ok = XmStringCreateSimple(‘'OK") ; // 01 

Program: graph.editor XtSetArgCeurgs [n] , XmNautoUnmemage , False); n++; 

Remarks: XtSetArgCaurgs [n] » XmNcancelLabelString, ok); n-i'-t’; 
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void print_opt_selection_cb(Widget opt, XtPointer which, if ( !prt_dialog) < 

XtPointer call.data) < prt.dialog * XmCroatePromptDialog (parent , "Printer", NULL, 0) ; 

XtVaSetValues (prt_dialog , 

XmString label; XmNdialogStyle , XmDIAL0G_FULL_APPLICATI0N_M0DAL, 

XmString prn.str; NULL); 
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Operator Property Popup Window condition expression by selecting the "If Condition" control. 
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APPENDIX E. INSTALLATION 



The PSDL Editor consists of the background checker and the graph editor. 
This appendix describes the process required to compile the graph editor as well as 
a PSDL Editor driver, used for debugging the graph editor. 



1. SOFTWARE REQUIREMENTS 

Table XIX contains the software and version numbers used to generate the 
graph editor. The graph editor was developed on a Sun workstation. 



2. COMPILING THE GRAPH EDITOR 

Contained within the graph editor source code is the file Makefile, used to 
build the graph editor. This file is configured to be executed from the graph editor 
source code directory, which is a subdirectory of a PSDL Editor directory. Prior to 
generating the graph editor, the user should set the default directory to that which 
contains the graph editor source code. The graph editor can be generated by simply 
typing “make” at the Unix prompt. If the graph editor compiles successfully, the 
image edit.graph will be generated. This file will automatically be located in the 
parent directory. In addition, the image sde will also be generated, in the parent 
directory. This is the PSDL Editor driver program, used to test the graph editor in 



Table XIX. Support Software 



Software 


Version 


Operating System 


SunOS Release 4.1.3 


C Compiler 


gcc Version 2.6.3 


C++ Compiler 


g++ Version 2.6.3 


Windows 


XI 1 Version 5 




Motif Version 1.1 


Make 


Sun Version 4.1 
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Table XX. Graph Editor Required Files 



edit -graph 


output-guard . hip 


error .hip 


print . hip 


exceptions. hip 


psdl-grammar . hip 


exceptions -list . hip 


spec-tool.hlp 


id-list .hip 


stream-property . hip 


inf orm-tool .hip 


streams . hip 


initial-State .hip 


timer-list .hip 


op_prop_f ormal-desc .hip 


timers .hip 


op_prop_inf ormal-desc . hip 


timers-tool . hip 


operator-property . hip 


trigger-if -cond . hip 


operators. hip 


types-tool.hlp 



a standalone fashion. 

Table XX provides a list of the graph editor files required to support the 
PSDL Editor. The file edit_graph is the image which executes the graph editor. 
The remainder of the files are help files, which are expected to be located in the 
directory from which the graph editor is executed. 



3. X WINDOW SYSTEM CUSOMIZATION 

The PSDL Editor uses Motif to build the graph editor. Consequentially, the 
X Window System initialization protocol used to define window parameters can be 
used with the PSDL Editor [Ref. 15]. These parameters can be defined in the file 
.Xresources-color^^, located in your home directory^® Table XXI provides sample 
declarations to set the default window size for the graph editor as well as for defining 
the delete key to work like the backspace key. 



in the file . Xresources-mono for non-color systems. 

^°Since this is a “dot” file, it will not appear under the Unix “Is” command. “Dot” files can be 
seen by using the -a flag (e.g., “Is -a”). 
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Table XXL X Window System Initialization 



edit_graph*geometry : =900x700 
edit_graph*XmText .translations : #override\n\ 

<Key>osf Delete : delete-previous-character () 
edit_graph*XmTextField . tr 2 mslations : #override\n\ 
<Key>osfDelete : delete-previous-characterO 
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